doc-detective-common 4.24.0 → 4.25.1

package/dist/types/generated/test_v3.d.ts

@@ -1338,7 +1338,7 @@ export type Routing51 = {
     [k: string]: unknown;
 };
 /**
- * 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. Supported extensions: [ '.mp4', '.webm', '.gif' ]
+ * 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;
 /**
@@ -1373,6 +1373,18 @@ export type ByIndex11 = number;
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
 export type ByName11 = string;
+/**
+ * Which app window to act on. Omit to use the active window. Apps have windows, no tabs.
+ */
+export type AppWindowSelector2 = ByIndex12 | ByName12 | ByCriteria12;
+/**
+ * Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened).
+ */
+export type ByIndex12 = number;
+/**
+ * Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
+ */
+export type ByName12 = string;
 /**
  * Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.
  */
@@ -1382,7 +1394,7 @@ export type RecordingEngine = RecordingEngineSimple | RecordingEngineDetailed;
  */
 export type RecordingEngineSimple = "browser" | "ffmpeg";
 /**
- * If `true`, starts recording — auto-selecting the `browser` engine for a visible Chrome context and the `ffmpeg` engine otherwise. If `false`, doesn't record.
+ * 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;
 /**
@@ -1536,7 +1548,7 @@ export type CloseSurface1 = Surface1 | [Surface2, ...Surface2[]];
 /**
  * The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.
  */
-export type Surface1 = SurfaceByName1 | ProcessSurface1 | BrowserSurface5 | AppSurface2;
+export type Surface1 = SurfaceByName1 | ProcessSurface1 | BrowserSurface5 | AppSurface3;
 /**
  * Name of the surface. A browser engine keyword (chrome|firefox|safari|webkit|edge) targets that browser; any other string names a background process. To target a browser window or tab, use the object form ({ "browser": …, "window": …, "tab": … }) — a plain string is never a window/tab name.
  */
@@ -1544,43 +1556,43 @@ export type SurfaceByName1 = string;
 /**
  * Which window to act on. Omit to use the active window.
  */
-export type WindowTabSelector10 = ByIndex12 | ByName12 | ByCriteria12;
+export type WindowTabSelector10 = ByIndex13 | ByName13 | ByCriteria13;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex12 = number;
+export type ByIndex13 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName12 = string;
+export type ByName13 = string;
 /**
  * Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order — including tabs the page opened itself.
  */
-export type WindowTabSelector11 = ByIndex13 | ByName13 | ByCriteria13;
+export type WindowTabSelector11 = ByIndex14 | ByName14 | ByCriteria14;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex13 = number;
+export type ByIndex14 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName13 = string;
+export type ByName14 = string;
 /**
  * Which app window to act on. Omit to use the active window. Apps have windows, no tabs.
  */
-export type AppWindowSelector2 = ByIndex14 | ByName14 | ByCriteria14;
+export type AppWindowSelector3 = ByIndex15 | ByName15 | ByCriteria15;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened).
  */
-export type ByIndex14 = number;
+export type ByIndex15 = number;
 /**
  * Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName14 = string;
+export type ByName15 = string;
 /**
  * The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.
  */
-export type Surface2 = SurfaceByName2 | ProcessSurface2 | BrowserSurface6 | AppSurface3;
+export type Surface2 = SurfaceByName2 | ProcessSurface2 | BrowserSurface6 | AppSurface4;
 /**
  * Name of the surface. A browser engine keyword (chrome|firefox|safari|webkit|edge) targets that browser; any other string names a background process. To target a browser window or tab, use the object form ({ "browser": …, "window": …, "tab": … }) — a plain string is never a window/tab name.
  */
@@ -1588,39 +1600,39 @@ export type SurfaceByName2 = string;
 /**
  * Which window to act on. Omit to use the active window.
  */
-export type WindowTabSelector12 = ByIndex15 | ByName15 | ByCriteria15;
+export type WindowTabSelector12 = ByIndex16 | ByName16 | ByCriteria16;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex15 = number;
+export type ByIndex16 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName15 = string;
+export type ByName16 = string;
 /**
  * Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order — including tabs the page opened itself.
  */
-export type WindowTabSelector13 = ByIndex16 | ByName16 | ByCriteria16;
+export type WindowTabSelector13 = ByIndex17 | ByName17 | ByCriteria17;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex16 = number;
+export type ByIndex17 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName16 = string;
+export type ByName17 = string;
 /**
  * Which app window to act on. Omit to use the active window. Apps have windows, no tabs.
  */
-export type AppWindowSelector3 = ByIndex17 | ByName17 | ByCriteria17;
+export type AppWindowSelector4 = ByIndex18 | ByName18 | ByCriteria18;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened).
  */
-export type ByIndex17 = number;
+export type ByIndex18 = number;
 /**
  * Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName17 = string;
+export type ByName18 = string;
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
@@ -1881,27 +1893,27 @@ export type SurfaceByBrowserEngine4 = "chrome" | "firefox" | "safari" | "webkit"
 /**
  * Which window to act on. Omit to use the active window.
  */
-export type WindowTabSelector14 = ByIndex18 | ByName18 | ByCriteria18;
+export type WindowTabSelector14 = ByIndex19 | ByName19 | ByCriteria19;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex18 = number;
+export type ByIndex19 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName18 = string;
+export type ByName19 = string;
 /**
  * Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order — including tabs the page opened itself.
  */
-export type WindowTabSelector15 = ByIndex19 | ByName19 | ByCriteria19;
+export type WindowTabSelector15 = ByIndex20 | ByName20 | ByCriteria20;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex19 = number;
+export type ByIndex20 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName19 = string;
+export type ByName20 = string;
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
@@ -2062,39 +2074,39 @@ export type SurfaceByBrowserEngine5 = "chrome" | "firefox" | "safari" | "webkit"
 /**
  * Which window to act on. Omit to use the active window.
  */
-export type WindowTabSelector16 = ByIndex20 | ByName20 | ByCriteria20;
+export type WindowTabSelector16 = ByIndex21 | ByName21 | ByCriteria21;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex20 = number;
+export type ByIndex21 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName20 = string;
+export type ByName21 = string;
 /**
  * Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order — including tabs the page opened itself.
  */
-export type WindowTabSelector17 = ByIndex21 | ByName21 | ByCriteria21;
+export type WindowTabSelector17 = ByIndex22 | ByName22 | ByCriteria22;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex21 = number;
+export type ByIndex22 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName21 = string;
+export type ByName22 = string;
 /**
  * Which app window to act on. Omit to use the active window. Apps have windows, no tabs.
  */
-export type AppWindowSelector4 = ByIndex22 | ByName22 | ByCriteria22;
+export type AppWindowSelector5 = ByIndex23 | ByName23 | ByCriteria23;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened).
  */
-export type ByIndex22 = number;
+export type ByIndex23 = number;
 /**
  * Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName22 = string;
+export type ByName23 = string;
 /**
  * Browser engine keyword. Targets that browser. Steps that can only ever act on a browser (not a background process) restrict the bare-string form to this enum, so a process name here is rejected at validation time instead of failing at runtime.
  */
@@ -2102,39 +2114,39 @@ export type SurfaceByBrowserEngine6 = "chrome" | "firefox" | "safari" | "webkit"
 /**
  * Which window to act on. Omit to use the active window.
  */
-export type WindowTabSelector18 = ByIndex23 | ByName23 | ByCriteria23;
+export type WindowTabSelector18 = ByIndex24 | ByName24 | ByCriteria24;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex23 = number;
+export type ByIndex24 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName23 = string;
+export type ByName24 = string;
 /**
  * Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order — including tabs the page opened itself.
  */
-export type WindowTabSelector19 = ByIndex24 | ByName24 | ByCriteria24;
+export type WindowTabSelector19 = ByIndex25 | ByName25 | ByCriteria25;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex24 = number;
+export type ByIndex25 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName24 = string;
+export type ByName25 = string;
 /**
  * Which app window to act on. Omit to use the active window. Apps have windows, no tabs.
  */
-export type AppWindowSelector5 = ByIndex25 | ByName25 | ByCriteria25;
+export type AppWindowSelector6 = ByIndex26 | ByName26 | ByCriteria26;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened).
  */
-export type ByIndex25 = number;
+export type ByIndex26 = number;
 /**
  * Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName25 = string;
+export type ByName26 = string;
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
@@ -2620,27 +2632,27 @@ export type SurfaceByBrowserEngine7 = "chrome" | "firefox" | "safari" | "webkit"
 /**
  * Which window to act on. Omit to use the active window.
  */
-export type WindowTabSelector20 = ByIndex26 | ByName26 | ByCriteria26;
+export type WindowTabSelector20 = ByIndex27 | ByName27 | ByCriteria27;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex26 = number;
+export type ByIndex27 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName26 = string;
+export type ByName27 = string;
 /**
  * Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order — including tabs the page opened itself.
  */
-export type WindowTabSelector21 = ByIndex27 | ByName27 | ByCriteria27;
+export type WindowTabSelector21 = ByIndex28 | ByName28 | ByCriteria28;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex27 = number;
+export type ByIndex28 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName27 = string;
+export type ByName28 = string;
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
@@ -2937,27 +2949,27 @@ export type SurfaceByBrowserEngine8 = "chrome" | "firefox" | "safari" | "webkit"
 /**
  * Which window to act on. Omit to use the active window.
  */
-export type WindowTabSelector22 = ByIndex28 | ByName28 | ByCriteria28;
+export type WindowTabSelector22 = ByIndex29 | ByName29 | ByCriteria29;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex28 = number;
+export type ByIndex29 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName28 = string;
+export type ByName29 = string;
 /**
  * Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order — including tabs the page opened itself.
  */
-export type WindowTabSelector23 = ByIndex29 | ByName29 | ByCriteria29;
+export type WindowTabSelector23 = ByIndex30 | ByName30 | ByCriteria30;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex29 = number;
+export type ByIndex30 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName29 = string;
+export type ByName30 = string;
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
@@ -3083,7 +3095,7 @@ export type TypeKeysSimple3 = string | string[];
 /**
  * The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.
  */
-export type Surface3 = SurfaceByName3 | ProcessSurface3 | BrowserSurface12 | AppSurface6;
+export type Surface3 = SurfaceByName3 | ProcessSurface3 | BrowserSurface12 | AppSurface7;
 /**
  * Name of the surface. A browser engine keyword (chrome|firefox|safari|webkit|edge) targets that browser; any other string names a background process. To target a browser window or tab, use the object form ({ "browser": …, "window": …, "tab": … }) — a plain string is never a window/tab name.
  */
@@ -3091,39 +3103,39 @@ export type SurfaceByName3 = string;
 /**
  * Which window to act on. Omit to use the active window.
  */
-export type WindowTabSelector24 = ByIndex30 | ByName30 | ByCriteria30;
+export type WindowTabSelector24 = ByIndex31 | ByName31 | ByCriteria31;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex30 = number;
+export type ByIndex31 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName30 = string;
+export type ByName31 = string;
 /**
  * Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order — including tabs the page opened itself.
  */
-export type WindowTabSelector25 = ByIndex31 | ByName31 | ByCriteria31;
+export type WindowTabSelector25 = ByIndex32 | ByName32 | ByCriteria32;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex31 = number;
+export type ByIndex32 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName31 = string;
+export type ByName32 = string;
 /**
  * Which app window to act on. Omit to use the active window. Apps have windows, no tabs.
  */
-export type AppWindowSelector6 = ByIndex32 | ByName32 | ByCriteria32;
+export type AppWindowSelector7 = ByIndex33 | ByName33 | ByCriteria33;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened).
  */
-export type ByIndex32 = number;
+export type ByIndex33 = number;
 /**
  * Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName32 = string;
+export type ByName33 = string;
 /**
  * Wait for a specific element to be present. At least one finding field must be specified.
  */
@@ -3240,39 +3252,39 @@ export type SurfaceByBrowserEngine9 = "chrome" | "firefox" | "safari" | "webkit"
 /**
  * Which window to act on. Omit to use the active window.
  */
-export type WindowTabSelector26 = ByIndex33 | ByName33 | ByCriteria33;
+export type WindowTabSelector26 = ByIndex34 | ByName34 | ByCriteria34;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex33 = number;
+export type ByIndex34 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName33 = string;
+export type ByName34 = string;
 /**
  * Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order — including tabs the page opened itself.
  */
-export type WindowTabSelector27 = ByIndex34 | ByName34 | ByCriteria34;
+export type WindowTabSelector27 = ByIndex35 | ByName35 | ByCriteria35;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex34 = number;
+export type ByIndex35 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName34 = string;
+export type ByName35 = string;
 /**
  * Which app window to act on. Omit to use the active window. Apps have windows, no tabs.
  */
-export type AppWindowSelector7 = ByIndex35 | ByName35 | ByCriteria35;
+export type AppWindowSelector8 = ByIndex36 | ByName36 | ByCriteria36;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened).
  */
-export type ByIndex35 = number;
+export type ByIndex36 = number;
 /**
  * Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName35 = string;
+export type ByName36 = string;
 /**
  * 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.
  */
@@ -3445,7 +3457,7 @@ export type Routing131 = {
     [k: string]: unknown;
 };
 /**
- * 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. Supported extensions: [ '.mp4', '.webm', '.gif' ]
+ * 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 Record3 = RecordSimple1 | RecordDetailed1 | RecordBoolean1;
 /**
@@ -3459,27 +3471,39 @@ export type SurfaceByBrowserEngine10 = "chrome" | "firefox" | "safari" | "webkit
 /**
  * Which window to act on. Omit to use the active window.
  */
-export type WindowTabSelector28 = ByIndex36 | ByName36 | ByCriteria36;
+export type WindowTabSelector28 = ByIndex37 | ByName37 | ByCriteria37;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex36 = number;
+export type ByIndex37 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName36 = string;
+export type ByName37 = string;
 /**
  * Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order — including tabs the page opened itself.
  */
-export type WindowTabSelector29 = ByIndex37 | ByName37 | ByCriteria37;
+export type WindowTabSelector29 = ByIndex38 | ByName38 | ByCriteria38;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex37 = number;
+export type ByIndex38 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName37 = string;
+export type ByName38 = string;
+/**
+ * Which app window to act on. Omit to use the active window. Apps have windows, no tabs.
+ */
+export type AppWindowSelector9 = ByIndex39 | ByName39 | ByCriteria39;
+/**
+ * Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened).
+ */
+export type ByIndex39 = number;
+/**
+ * Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
+ */
+export type ByName39 = string;
 /**
  * Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.
  */
@@ -3489,7 +3513,7 @@ export type RecordingEngine1 = RecordingEngineSimple1 | RecordingEngineDetailed1
  */
 export type RecordingEngineSimple1 = "browser" | "ffmpeg";
 /**
- * If `true`, starts recording — auto-selecting the `browser` engine for a visible Chrome context and the `ffmpeg` engine otherwise. If `false`, doesn't record.
+ * 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 RecordBoolean1 = boolean;
 /**
@@ -3643,7 +3667,7 @@ export type CloseSurface3 = Surface4 | [Surface5, ...Surface5[]];
 /**
  * The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.
  */
-export type Surface4 = SurfaceByName4 | ProcessSurface4 | BrowserSurface15 | AppSurface8;
+export type Surface4 = SurfaceByName4 | ProcessSurface4 | BrowserSurface15 | AppSurface10;
 /**
  * Name of the surface. A browser engine keyword (chrome|firefox|safari|webkit|edge) targets that browser; any other string names a background process. To target a browser window or tab, use the object form ({ "browser": …, "window": …, "tab": … }) — a plain string is never a window/tab name.
  */
@@ -3651,43 +3675,43 @@ export type SurfaceByName4 = string;
 /**
  * Which window to act on. Omit to use the active window.
  */
-export type WindowTabSelector30 = ByIndex38 | ByName38 | ByCriteria38;
+export type WindowTabSelector30 = ByIndex40 | ByName40 | ByCriteria40;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex38 = number;
+export type ByIndex40 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName38 = string;
+export type ByName40 = string;
 /**
  * Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order — including tabs the page opened itself.
  */
-export type WindowTabSelector31 = ByIndex39 | ByName39 | ByCriteria39;
+export type WindowTabSelector31 = ByIndex41 | ByName41 | ByCriteria41;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex39 = number;
+export type ByIndex41 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName39 = string;
+export type ByName41 = string;
 /**
  * Which app window to act on. Omit to use the active window. Apps have windows, no tabs.
  */
-export type AppWindowSelector8 = ByIndex40 | ByName40 | ByCriteria40;
+export type AppWindowSelector10 = ByIndex42 | ByName42 | ByCriteria42;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened).
  */
-export type ByIndex40 = number;
+export type ByIndex42 = number;
 /**
  * Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName40 = string;
+export type ByName42 = string;
 /**
  * The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.
  */
-export type Surface5 = SurfaceByName5 | ProcessSurface5 | BrowserSurface16 | AppSurface9;
+export type Surface5 = SurfaceByName5 | ProcessSurface5 | BrowserSurface16 | AppSurface11;
 /**
  * Name of the surface. A browser engine keyword (chrome|firefox|safari|webkit|edge) targets that browser; any other string names a background process. To target a browser window or tab, use the object form ({ "browser": …, "window": …, "tab": … }) — a plain string is never a window/tab name.
  */
@@ -3695,39 +3719,39 @@ export type SurfaceByName5 = string;
 /**
  * Which window to act on. Omit to use the active window.
  */
-export type WindowTabSelector32 = ByIndex41 | ByName41 | ByCriteria41;
+export type WindowTabSelector32 = ByIndex43 | ByName43 | ByCriteria43;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex41 = number;
+export type ByIndex43 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName41 = string;
+export type ByName43 = string;
 /**
  * Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order — including tabs the page opened itself.
  */
-export type WindowTabSelector33 = ByIndex42 | ByName42 | ByCriteria42;
+export type WindowTabSelector33 = ByIndex44 | ByName44 | ByCriteria44;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex42 = number;
+export type ByIndex44 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName42 = string;
+export type ByName44 = string;
 /**
  * Which app window to act on. Omit to use the active window. Apps have windows, no tabs.
  */
-export type AppWindowSelector9 = ByIndex43 | ByName43 | ByCriteria43;
+export type AppWindowSelector11 = ByIndex45 | ByName45 | ByCriteria45;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened).
  */
-export type ByIndex43 = number;
+export type ByIndex45 = number;
 /**
  * Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName43 = string;
+export type ByName45 = string;
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
@@ -3988,27 +4012,27 @@ export type SurfaceByBrowserEngine11 = "chrome" | "firefox" | "safari" | "webkit
 /**
  * Which window to act on. Omit to use the active window.
  */
-export type WindowTabSelector34 = ByIndex44 | ByName44 | ByCriteria44;
+export type WindowTabSelector34 = ByIndex46 | ByName46 | ByCriteria46;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex44 = number;
+export type ByIndex46 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName44 = string;
+export type ByName46 = string;
 /**
  * Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order — including tabs the page opened itself.
  */
-export type WindowTabSelector35 = ByIndex45 | ByName45 | ByCriteria45;
+export type WindowTabSelector35 = ByIndex47 | ByName47 | ByCriteria47;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex45 = number;
+export type ByIndex47 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName45 = string;
+export type ByName47 = string;
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
@@ -4169,39 +4193,39 @@ export type SurfaceByBrowserEngine12 = "chrome" | "firefox" | "safari" | "webkit
 /**
  * Which window to act on. Omit to use the active window.
  */
-export type WindowTabSelector36 = ByIndex46 | ByName46 | ByCriteria46;
+export type WindowTabSelector36 = ByIndex48 | ByName48 | ByCriteria48;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex46 = number;
+export type ByIndex48 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName46 = string;
+export type ByName48 = string;
 /**
  * Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order — including tabs the page opened itself.
  */
-export type WindowTabSelector37 = ByIndex47 | ByName47 | ByCriteria47;
+export type WindowTabSelector37 = ByIndex49 | ByName49 | ByCriteria49;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex47 = number;
+export type ByIndex49 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName47 = string;
+export type ByName49 = string;
 /**
  * Which app window to act on. Omit to use the active window. Apps have windows, no tabs.
  */
-export type AppWindowSelector10 = ByIndex48 | ByName48 | ByCriteria48;
+export type AppWindowSelector12 = ByIndex50 | ByName50 | ByCriteria50;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened).
  */
-export type ByIndex48 = number;
+export type ByIndex50 = number;
 /**
  * Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName48 = string;
+export type ByName50 = string;
 /**
  * Browser engine keyword. Targets that browser. Steps that can only ever act on a browser (not a background process) restrict the bare-string form to this enum, so a process name here is rejected at validation time instead of failing at runtime.
  */
@@ -4209,39 +4233,39 @@ export type SurfaceByBrowserEngine13 = "chrome" | "firefox" | "safari" | "webkit
 /**
  * Which window to act on. Omit to use the active window.
  */
-export type WindowTabSelector38 = ByIndex49 | ByName49 | ByCriteria49;
+export type WindowTabSelector38 = ByIndex51 | ByName51 | ByCriteria51;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex49 = number;
+export type ByIndex51 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName49 = string;
+export type ByName51 = string;
 /**
  * Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order — including tabs the page opened itself.
  */
-export type WindowTabSelector39 = ByIndex50 | ByName50 | ByCriteria50;
+export type WindowTabSelector39 = ByIndex52 | ByName52 | ByCriteria52;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex50 = number;
+export type ByIndex52 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName50 = string;
+export type ByName52 = string;
 /**
  * Which app window to act on. Omit to use the active window. Apps have windows, no tabs.
  */
-export type AppWindowSelector11 = ByIndex51 | ByName51 | ByCriteria51;
+export type AppWindowSelector13 = ByIndex53 | ByName53 | ByCriteria53;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened).
  */
-export type ByIndex51 = number;
+export type ByIndex53 = number;
 /**
  * Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName51 = string;
+export type ByName53 = string;
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
@@ -6721,9 +6745,9 @@ export interface Record {
 }
 export interface RecordDetailed {
     /**
-     * The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.
+     * The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": … }) and are captured via the `ffmpeg` engine, cropped to the app window by default.
      */
-    surface?: SurfaceByBrowserEngine3 | BrowserSurface4;
+    surface?: SurfaceByBrowserEngine3 | BrowserSurface4 | AppSurface2;
     /**
      * 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`.
      */
@@ -6791,13 +6815,34 @@ export interface ByCriteria11 {
      */
     url?: string;
 }
+export interface AppSurface2 {
+    /**
+     * Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier).
+     */
+    app: string;
+    window?: AppWindowSelector2;
+}
+export interface ByCriteria12 {
+    /**
+     * Assigned window name.
+     */
+    name?: string;
+    /**
+     * Index in creation order. Negative counts from the end.
+     */
+    index?: number;
+    /**
+     * Window title to match. Substring, or /regex/.
+     */
+    title?: string;
+}
 export interface RecordingEngineDetailed {
     /**
      * Recording engine. `browser` records the Chrome viewport (concurrency-safe); `ffmpeg` records the screen and supports any application.
      */
     name: "browser" | "ffmpeg";
     /**
-     * What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).
+     * What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).
      */
     target?: "display" | "window" | "viewport";
     /**
@@ -7103,7 +7148,7 @@ export interface BrowserSurface5 {
     window?: WindowTabSelector10;
     tab?: WindowTabSelector11;
 }
-export interface ByCriteria12 {
+export interface ByCriteria13 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -7121,7 +7166,7 @@ export interface ByCriteria12 {
      */
     url?: string;
 }
-export interface ByCriteria13 {
+export interface ByCriteria14 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -7139,14 +7184,14 @@ export interface ByCriteria13 {
      */
     url?: string;
 }
-export interface AppSurface2 {
+export interface AppSurface3 {
     /**
      * Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier).
      */
     app: string;
-    window?: AppWindowSelector2;
+    window?: AppWindowSelector3;
 }
-export interface ByCriteria14 {
+export interface ByCriteria15 {
     /**
      * Assigned window name.
      */
@@ -7178,7 +7223,7 @@ export interface BrowserSurface6 {
     window?: WindowTabSelector12;
     tab?: WindowTabSelector13;
 }
-export interface ByCriteria15 {
+export interface ByCriteria16 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -7196,7 +7241,7 @@ export interface ByCriteria15 {
      */
     url?: string;
 }
-export interface ByCriteria16 {
+export interface ByCriteria17 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -7214,14 +7259,14 @@ export interface ByCriteria16 {
      */
     url?: string;
 }
-export interface AppSurface3 {
+export interface AppSurface4 {
     /**
      * Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier).
      */
     app: string;
-    window?: AppWindowSelector3;
+    window?: AppWindowSelector4;
 }
-export interface ByCriteria17 {
+export interface ByCriteria18 {
     /**
      * Assigned window name.
      */
@@ -7778,7 +7823,7 @@ export interface BrowserSurface7 {
     window?: WindowTabSelector14;
     tab?: WindowTabSelector15;
 }
-export interface ByCriteria18 {
+export interface ByCriteria19 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -7796,7 +7841,7 @@ export interface ByCriteria18 {
      */
     url?: string;
 }
-export interface ByCriteria19 {
+export interface ByCriteria20 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -8101,7 +8146,7 @@ export interface SwipeDirectional {
     /**
      * The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": … }).
      */
-    surface?: SurfaceByBrowserEngine5 | BrowserSurface8 | AppSurface4;
+    surface?: SurfaceByBrowserEngine5 | BrowserSurface8 | AppSurface5;
 }
 export interface BrowserSurface8 {
     /**
@@ -8115,7 +8160,7 @@ export interface BrowserSurface8 {
     window?: WindowTabSelector16;
     tab?: WindowTabSelector17;
 }
-export interface ByCriteria20 {
+export interface ByCriteria21 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -8133,7 +8178,7 @@ export interface ByCriteria20 {
      */
     url?: string;
 }
-export interface ByCriteria21 {
+export interface ByCriteria22 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -8151,14 +8196,14 @@ export interface ByCriteria21 {
      */
     url?: string;
 }
-export interface AppSurface4 {
+export interface AppSurface5 {
     /**
      * Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier).
      */
     app: string;
-    window?: AppWindowSelector4;
+    window?: AppWindowSelector5;
 }
-export interface ByCriteria22 {
+export interface ByCriteria23 {
     /**
      * Assigned window name.
      */
@@ -8182,7 +8227,7 @@ export interface SwipePointToPoint {
     /**
      * The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": … }).
      */
-    surface?: SurfaceByBrowserEngine6 | BrowserSurface9 | AppSurface5;
+    surface?: SurfaceByBrowserEngine6 | BrowserSurface9 | AppSurface6;
 }
 /**
  * A pixel coordinate on the surface, measured from its top-left corner (0, 0).
@@ -8222,7 +8267,7 @@ export interface BrowserSurface9 {
     window?: WindowTabSelector18;
     tab?: WindowTabSelector19;
 }
-export interface ByCriteria23 {
+export interface ByCriteria24 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -8240,7 +8285,7 @@ export interface ByCriteria23 {
      */
     url?: string;
 }
-export interface ByCriteria24 {
+export interface ByCriteria25 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -8258,14 +8303,14 @@ export interface ByCriteria24 {
      */
     url?: string;
 }
-export interface AppSurface5 {
+export interface AppSurface6 {
     /**
      * Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier).
      */
     app: string;
-    window?: AppWindowSelector5;
+    window?: AppWindowSelector6;
 }
-export interface ByCriteria25 {
+export interface ByCriteria26 {
     /**
      * Assigned window name.
      */
@@ -9072,7 +9117,7 @@ export interface BrowserSurface10 {
     window?: WindowTabSelector20;
     tab?: WindowTabSelector21;
 }
-export interface ByCriteria26 {
+export interface ByCriteria27 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -9090,7 +9135,7 @@ export interface ByCriteria26 {
      */
     url?: string;
 }
-export interface ByCriteria27 {
+export interface ByCriteria28 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -9875,7 +9920,7 @@ export interface BrowserSurface11 {
     window?: WindowTabSelector22;
     tab?: WindowTabSelector23;
 }
-export interface ByCriteria28 {
+export interface ByCriteria29 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -9893,7 +9938,7 @@ export interface ByCriteria28 {
      */
     url?: string;
 }
-export interface ByCriteria29 {
+export interface ByCriteria30 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -10066,7 +10111,7 @@ export interface BrowserSurface12 {
     window?: WindowTabSelector24;
     tab?: WindowTabSelector25;
 }
-export interface ByCriteria30 {
+export interface ByCriteria31 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -10084,7 +10129,7 @@ export interface ByCriteria30 {
      */
     url?: string;
 }
-export interface ByCriteria31 {
+export interface ByCriteria32 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -10102,14 +10147,14 @@ export interface ByCriteria31 {
      */
     url?: string;
 }
-export interface AppSurface6 {
+export interface AppSurface7 {
     /**
      * Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier).
      */
     app: string;
-    window?: AppWindowSelector6;
+    window?: AppWindowSelector7;
 }
-export interface ByCriteria32 {
+export interface ByCriteria33 {
     /**
      * Assigned window name.
      */
@@ -10310,7 +10355,7 @@ export interface CaptureScreenshotFields1 {
     /**
      * The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": … }). App captures don't support `crop` yet.
      */
-    surface?: SurfaceByBrowserEngine9 | BrowserSurface13 | AppSurface7;
+    surface?: SurfaceByBrowserEngine9 | BrowserSurface13 | AppSurface8;
     path?: ScreenshotSimple3;
     /**
      * Directory of the PNG file. If the directory doesn't exist, creates the directory.
@@ -10340,7 +10385,7 @@ export interface BrowserSurface13 {
     window?: WindowTabSelector26;
     tab?: WindowTabSelector27;
 }
-export interface ByCriteria33 {
+export interface ByCriteria34 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -10358,7 +10403,7 @@ export interface ByCriteria33 {
      */
     url?: string;
 }
-export interface ByCriteria34 {
+export interface ByCriteria35 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -10376,14 +10421,14 @@ export interface ByCriteria34 {
      */
     url?: string;
 }
-export interface AppSurface7 {
+export interface AppSurface8 {
     /**
      * Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier).
      */
     app: string;
-    window?: AppWindowSelector7;
+    window?: AppWindowSelector8;
 }
-export interface ByCriteria35 {
+export interface ByCriteria36 {
     /**
      * Assigned window name.
      */
@@ -10701,9 +10746,9 @@ export interface Record2 {
 }
 export interface RecordDetailed1 {
     /**
-     * The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.
+     * The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": … }) and are captured via the `ffmpeg` engine, cropped to the app window by default.
      */
-    surface?: SurfaceByBrowserEngine10 | BrowserSurface14;
+    surface?: SurfaceByBrowserEngine10 | BrowserSurface14 | AppSurface9;
     /**
      * 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`.
      */
@@ -10735,7 +10780,7 @@ export interface BrowserSurface14 {
     window?: WindowTabSelector28;
     tab?: WindowTabSelector29;
 }
-export interface ByCriteria36 {
+export interface ByCriteria37 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -10753,7 +10798,7 @@ export interface ByCriteria36 {
      */
     url?: string;
 }
-export interface ByCriteria37 {
+export interface ByCriteria38 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -10771,13 +10816,34 @@ export interface ByCriteria37 {
      */
     url?: string;
 }
+export interface AppSurface9 {
+    /**
+     * Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier).
+     */
+    app: string;
+    window?: AppWindowSelector9;
+}
+export interface ByCriteria39 {
+    /**
+     * Assigned window name.
+     */
+    name?: string;
+    /**
+     * Index in creation order. Negative counts from the end.
+     */
+    index?: number;
+    /**
+     * Window title to match. Substring, or /regex/.
+     */
+    title?: string;
+}
 export interface RecordingEngineDetailed1 {
     /**
      * Recording engine. `browser` records the Chrome viewport (concurrency-safe); `ffmpeg` records the screen and supports any application.
      */
     name: "browser" | "ffmpeg";
     /**
-     * What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).
+     * What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).
      */
     target?: "display" | "window" | "viewport";
     /**
@@ -11083,7 +11149,7 @@ export interface BrowserSurface15 {
     window?: WindowTabSelector30;
     tab?: WindowTabSelector31;
 }
-export interface ByCriteria38 {
+export interface ByCriteria40 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -11101,7 +11167,7 @@ export interface ByCriteria38 {
      */
     url?: string;
 }
-export interface ByCriteria39 {
+export interface ByCriteria41 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -11119,14 +11185,14 @@ export interface ByCriteria39 {
      */
     url?: string;
 }
-export interface AppSurface8 {
+export interface AppSurface10 {
     /**
      * Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier).
      */
     app: string;
-    window?: AppWindowSelector8;
+    window?: AppWindowSelector10;
 }
-export interface ByCriteria40 {
+export interface ByCriteria42 {
     /**
      * Assigned window name.
      */
@@ -11158,7 +11224,7 @@ export interface BrowserSurface16 {
     window?: WindowTabSelector32;
     tab?: WindowTabSelector33;
 }
-export interface ByCriteria41 {
+export interface ByCriteria43 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -11176,7 +11242,7 @@ export interface ByCriteria41 {
      */
     url?: string;
 }
-export interface ByCriteria42 {
+export interface ByCriteria44 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -11194,14 +11260,14 @@ export interface ByCriteria42 {
      */
     url?: string;
 }
-export interface AppSurface9 {
+export interface AppSurface11 {
     /**
      * Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier).
      */
     app: string;
-    window?: AppWindowSelector9;
+    window?: AppWindowSelector11;
 }
-export interface ByCriteria43 {
+export interface ByCriteria45 {
     /**
      * Assigned window name.
      */
@@ -11758,7 +11824,7 @@ export interface BrowserSurface17 {
     window?: WindowTabSelector34;
     tab?: WindowTabSelector35;
 }
-export interface ByCriteria44 {
+export interface ByCriteria46 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -11776,7 +11842,7 @@ export interface ByCriteria44 {
      */
     url?: string;
 }
-export interface ByCriteria45 {
+export interface ByCriteria47 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -12081,7 +12147,7 @@ export interface SwipeDirectional1 {
     /**
      * The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": … }).
      */
-    surface?: SurfaceByBrowserEngine12 | BrowserSurface18 | AppSurface10;
+    surface?: SurfaceByBrowserEngine12 | BrowserSurface18 | AppSurface12;
 }
 export interface BrowserSurface18 {
     /**
@@ -12095,7 +12161,7 @@ export interface BrowserSurface18 {
     window?: WindowTabSelector36;
     tab?: WindowTabSelector37;
 }
-export interface ByCriteria46 {
+export interface ByCriteria48 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -12113,7 +12179,7 @@ export interface ByCriteria46 {
      */
     url?: string;
 }
-export interface ByCriteria47 {
+export interface ByCriteria49 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -12131,14 +12197,14 @@ export interface ByCriteria47 {
      */
     url?: string;
 }
-export interface AppSurface10 {
+export interface AppSurface12 {
     /**
      * Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier).
      */
     app: string;
-    window?: AppWindowSelector10;
+    window?: AppWindowSelector12;
 }
-export interface ByCriteria48 {
+export interface ByCriteria50 {
     /**
      * Assigned window name.
      */
@@ -12162,7 +12228,7 @@ export interface SwipePointToPoint1 {
     /**
      * The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": … }).
      */
-    surface?: SurfaceByBrowserEngine13 | BrowserSurface19 | AppSurface11;
+    surface?: SurfaceByBrowserEngine13 | BrowserSurface19 | AppSurface13;
 }
 /**
  * A pixel coordinate on the surface, measured from its top-left corner (0, 0).
@@ -12202,7 +12268,7 @@ export interface BrowserSurface19 {
     window?: WindowTabSelector38;
     tab?: WindowTabSelector39;
 }
-export interface ByCriteria49 {
+export interface ByCriteria51 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -12220,7 +12286,7 @@ export interface ByCriteria49 {
      */
     url?: string;
 }
-export interface ByCriteria50 {
+export interface ByCriteria52 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -12238,14 +12304,14 @@ export interface ByCriteria50 {
      */
     url?: string;
 }
-export interface AppSurface11 {
+export interface AppSurface13 {
     /**
      * Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier).
      */
     app: string;
-    window?: AppWindowSelector11;
+    window?: AppWindowSelector13;
 }
-export interface ByCriteria51 {
+export interface ByCriteria53 {
     /**
      * Assigned window name.
      */