@docsxai/engine 0.2.0 → 0.2.1-rc.1

package/README.md

@@ -10,6 +10,7 @@ The engine **never** calls a model API. Calibration-time inference is supplied b
 - **Execution environment** — optional `environment` block (`EnvironmentSpec`): frozen `clock` (Playwright clock API), `locale`, `timezone`, `viewport` (`VIEWPORT_PRESETS`: desktop / tablet / mobile, or explicit size), `color_scheme`, `reduced_motion`. Applied at context creation by `launchPlaywrightSession({ environment })`; on CDP-attached sessions only the clock applies (one stderr warning lists skipped fields). `contextOptions` passes `httpCredentials` / `clientCertificates` / `extraHTTPHeaders` through to `browser.newContext`.
 - **Redactions** — flow-level + per-step `RedactionSpec[]` (`{ selector }` or `{ region }`, style `box` | `pixelate`) masked deterministically before any screenshot (halt shots included) hits disk. The pure pixel transform is `applyRedactions` in `redact.ts`.
 - **`BrowserDriver`** interface — what the runtime needs from a browser. The `PlaywrightDriver` implementation includes the `actionable()` predicate (see [`docs/actionability-contract.md`](../../docs/actionability-contract.md)) that browser-bridge consumers can mirror, plus a real `element_stable` wait (bounding-box polling, 10 s best-effort budget).
+- **Annotation obstacles** — opt-in (`.docsxai.json` → `"annotations": { "obstacles": true }`, default off). After a step's screenshot, `runFlow` asks the driver for `nearbyBoxes(selector, 320)`: the visible text (per rendered line) and interactive elements around the target, in screenshot pixels, the target's subtree and elements containing it excluded. The pure `selectObstacles` (`obstacles.ts`) rounds boxes outward to whole pixels, clips them to the screenshot, drops duplicates, boxes inside the target and boxes covered by another kept box, caps at the 40 nearest and sorts by y, x, width, height. The result lands as `obstacles` on the annotation record, where the viewer's `burn` uses it to keep callouts off page content. The scan reads the page's own DOM (no iframe or shadow-root content) and runs only through the driver, so any `BrowserDriver` must implement `nearbyBoxes`. Off or absent, records and screenshots are unchanged.
 - **Auth strategies** — `auth/strategy.yaml` descriptor + a catalogue of scripted strategies (`api-login`, `ui-form` with a TOTP hop, `email-otp`, `webauthn`, `jwt-injection`, `http-basic`, `pat-header`, `mtls`, `test-backdoor`) alongside the human-in-the-loop `manual-capture`. See [Auth strategies](#auth-strategies) below.
 - **CLI** — `docsxai <command>`. See `--help` or the [top-level README](../../README.md) for the full surface; this package's `dist/cli.js` is the binary.
 
@@ -31,6 +32,10 @@ zip            package the doc pack for hand-off
 baseline       snapshot the doc pack (flows, prose, annotations, screenshots, locators) for drift comparison
 diff           deterministic drift report against a baseline (--fail-on warn|fail gates CI)
 export         project the doc pack to a publisher format (`export adf` — Confluence ADF; `export playwright` — Playwright specs)
+plugins        list / info / sync the workspace plugin set (see Plugins below)
+login          validate a backend bearer token (`--oauth` runs the OAuth 2.1 + PKCE flow)
+push           upload the doc pack to the backend as a new revision
+pull           fetch a backend revision's artifacts into the workspace
 ```
 
 `run` has a sub-3-second iteration mode for long-async flows: `--start-from <step-id> --cdp <endpoint>` skips every step before the target and attaches to an already-warm Chrome.
@@ -104,7 +109,7 @@ The register module exports a `register(api)` function (named or default). `api`
 
 ### Workspace config + lock
 
-Two optional `.docsxai.json` keys wire plugins into a workspace:
+Two optional `.docsxai.json` keys wire plugins into a workspace (a third, `annotations.obstacles`, switches on obstacle scanning for `run`; see the engine overview above):
 
 ```json
 {
@@ -113,6 +118,8 @@ Two optional `.docsxai.json` keys wire plugins into a workspace:
 }
 ```
 
+`@docsxai/plugin-confluence` is repo-only (`private: true`, not on npm). Build it in a checkout (`pnpm -r build`) and wire it by path instead: `{ "path": "<checkout>/packages/plugin-confluence" }`. The `{ "package": ... }` form resolves only once the package is installed in the workspace.
+
 `plugins-lock.json` (schema `docsxai/plugins-lock@1`, next to the config) pins each plugin's register-module sha256. When it exists, every resolve verifies the bytes **before** importing; a mismatch fails closed with a "run `docsxai plugins sync`" message.
 
 ### CLI

package/dist/auth/api-login.d.ts

@@ -34,9 +34,9 @@ export declare const ApiLoginOptions: z.ZodObject<{
         equals?: unknown;
     }>]>>;
 }, "strict", z.ZodTypeAny, {
-    method: string;
     login_url: string;
-    body_format: "json" | "form";
+    method: string;
+    body_format: "form" | "json";
     success_check?: {
         cookie: string;
     } | {
@@ -48,7 +48,7 @@ export declare const ApiLoginOptions: z.ZodObject<{
 }, {
     login_url: string;
     method?: string | undefined;
-    body_format?: "json" | "form" | undefined;
+    body_format?: "form" | "json" | undefined;
     success_check?: {
         cookie: string;
     } | {

package/dist/auth/api-login.js

@@ -45,14 +45,18 @@ export class ApiLoginStrategy {
         const opts = parseStrategyOptions(this.name, ApiLoginOptions, ctx.options);
         const url = new URL(opts.login_url, ctx.baseURL);
         const isJson = opts.body_format === "json";
+        // GET and HEAD cannot carry a body (fetch throws), so a link-style login sends none.
+        const hasBody = !["GET", "HEAD"].includes(opts.method.toUpperCase());
         const body = isJson ? JSON.stringify(ctx.creds) : new URLSearchParams(ctx.creds).toString();
         const result = await fetchCollectingCookies(url, {
             method: opts.method,
             headers: {
-                "content-type": isJson ? "application/json" : "application/x-www-form-urlencoded",
+                ...(hasBody
+                    ? { "content-type": isJson ? "application/json" : "application/x-www-form-urlencoded" }
+                    : {}),
                 accept: "application/json, text/html;q=0.9, */*;q=0.8",
             },
-            body,
+            ...(hasBody ? { body } : {}),
         }, { fetchImpl: this.fetchImpl });
         // Failure messages name the endpoint and the check — never the credential values.
         const check = opts.success_check;

package/dist/auth/email-otp.d.ts

@@ -47,17 +47,17 @@ export declare const EmailOtpInboxOptions: z.ZodObject<{
     /** How long to wait for the code mail. Default 30000. */
     timeout_ms: z.ZodDefault<z.ZodNumber>;
 }, "strict", z.ZodTypeAny, {
-    options: Record<string, unknown>;
-    timeout_ms: number;
     provider: string;
-    code_pattern: string;
+    options: Record<string, unknown>;
     to_env?: string | undefined;
+    code_pattern: string;
+    timeout_ms: number;
 }, {
-    options?: Record<string, unknown> | undefined;
-    timeout_ms?: number | undefined;
     provider?: string | undefined;
+    options?: Record<string, unknown> | undefined;
     to_env?: string | undefined;
     code_pattern?: string | undefined;
+    timeout_ms?: number | undefined;
 }>;
 export type EmailOtpInboxOptions = z.infer<typeof EmailOtpInboxOptions>;
 export declare const EmailOtpOptions: z.ZodEffects<z.ZodObject<{
@@ -76,12 +76,12 @@ export declare const EmailOtpOptions: z.ZodEffects<z.ZodObject<{
         selector: z.ZodString;
         value_env: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
+        action: "click" | "fill";
         selector: string;
-        action: "fill" | "click";
         value_env?: string | undefined;
     }, {
+        action: "click" | "fill";
         selector: string;
-        action: "fill" | "click";
         value_env?: string | undefined;
     }>, "many">>;
     inbox: z.ZodObject<{
@@ -95,110 +95,110 @@ export declare const EmailOtpOptions: z.ZodEffects<z.ZodObject<{
         /** How long to wait for the code mail. Default 30000. */
         timeout_ms: z.ZodDefault<z.ZodNumber>;
     }, "strict", z.ZodTypeAny, {
-        options: Record<string, unknown>;
-        timeout_ms: number;
         provider: string;
-        code_pattern: string;
+        options: Record<string, unknown>;
         to_env?: string | undefined;
+        code_pattern: string;
+        timeout_ms: number;
     }, {
-        options?: Record<string, unknown> | undefined;
-        timeout_ms?: number | undefined;
         provider?: string | undefined;
+        options?: Record<string, unknown> | undefined;
         to_env?: string | undefined;
         code_pattern?: string | undefined;
+        timeout_ms?: number | undefined;
     }>;
 }, "strict", z.ZodTypeAny, {
-    timeout_ms: number;
     login_url: string;
-    ignore_https_errors: boolean;
-    otp_selector: string;
-    submit_selector: string;
     username_selector: string;
     password_selector: string;
+    submit_selector: string;
+    otp_selector: string;
+    otp_submit_selector?: string | undefined;
+    success_selector?: string | undefined;
+    url_matches?: string | undefined;
+    timeout_ms: number;
+    ignore_https_errors: boolean;
     pre_steps: {
+        action: "click" | "fill";
         selector: string;
-        action: "fill" | "click";
         value_env?: string | undefined;
     }[];
     inbox: {
-        options: Record<string, unknown>;
-        timeout_ms: number;
         provider: string;
-        code_pattern: string;
+        options: Record<string, unknown>;
         to_env?: string | undefined;
+        code_pattern: string;
+        timeout_ms: number;
     };
-    url_matches?: string | undefined;
-    success_selector?: string | undefined;
-    otp_submit_selector?: string | undefined;
 }, {
     login_url: string;
-    otp_selector: string;
-    submit_selector: string;
     username_selector: string;
     password_selector: string;
-    inbox: {
-        options?: Record<string, unknown> | undefined;
-        timeout_ms?: number | undefined;
-        provider?: string | undefined;
-        to_env?: string | undefined;
-        code_pattern?: string | undefined;
-    };
-    timeout_ms?: number | undefined;
+    submit_selector: string;
+    otp_selector: string;
+    otp_submit_selector?: string | undefined;
+    success_selector?: string | undefined;
     url_matches?: string | undefined;
+    timeout_ms?: number | undefined;
     ignore_https_errors?: boolean | undefined;
-    success_selector?: string | undefined;
     pre_steps?: {
+        action: "click" | "fill";
         selector: string;
-        action: "fill" | "click";
         value_env?: string | undefined;
     }[] | undefined;
-    otp_submit_selector?: string | undefined;
+    inbox: {
+        provider?: string | undefined;
+        options?: Record<string, unknown> | undefined;
+        to_env?: string | undefined;
+        code_pattern?: string | undefined;
+        timeout_ms?: number | undefined;
+    };
 }>, {
-    timeout_ms: number;
     login_url: string;
-    ignore_https_errors: boolean;
-    otp_selector: string;
-    submit_selector: string;
     username_selector: string;
     password_selector: string;
+    submit_selector: string;
+    otp_selector: string;
+    otp_submit_selector?: string | undefined;
+    success_selector?: string | undefined;
+    url_matches?: string | undefined;
+    timeout_ms: number;
+    ignore_https_errors: boolean;
     pre_steps: {
+        action: "click" | "fill";
         selector: string;
-        action: "fill" | "click";
         value_env?: string | undefined;
     }[];
     inbox: {
-        options: Record<string, unknown>;
-        timeout_ms: number;
         provider: string;
-        code_pattern: string;
+        options: Record<string, unknown>;
         to_env?: string | undefined;
+        code_pattern: string;
+        timeout_ms: number;
     };
-    url_matches?: string | undefined;
-    success_selector?: string | undefined;
-    otp_submit_selector?: string | undefined;
 }, {
     login_url: string;
-    otp_selector: string;
-    submit_selector: string;
     username_selector: string;
     password_selector: string;
-    inbox: {
-        options?: Record<string, unknown> | undefined;
-        timeout_ms?: number | undefined;
-        provider?: string | undefined;
-        to_env?: string | undefined;
-        code_pattern?: string | undefined;
-    };
-    timeout_ms?: number | undefined;
+    submit_selector: string;
+    otp_selector: string;
+    otp_submit_selector?: string | undefined;
+    success_selector?: string | undefined;
     url_matches?: string | undefined;
+    timeout_ms?: number | undefined;
     ignore_https_errors?: boolean | undefined;
-    success_selector?: string | undefined;
     pre_steps?: {
+        action: "click" | "fill";
         selector: string;
-        action: "fill" | "click";
         value_env?: string | undefined;
     }[] | undefined;
-    otp_submit_selector?: string | undefined;
+    inbox: {
+        provider?: string | undefined;
+        options?: Record<string, unknown> | undefined;
+        to_env?: string | undefined;
+        code_pattern?: string | undefined;
+        timeout_ms?: number | undefined;
+    };
 }>;
 export type EmailOtpOptions = z.infer<typeof EmailOtpOptions>;
 export declare class EmailOtpStrategy implements AuthStrategy {

package/dist/auth/jwt-injection.d.ts

@@ -26,119 +26,119 @@ export declare const JwtInjectionOptions: z.ZodEffects<z.ZodObject<{
         }, "strict", z.ZodTypeAny, {
             name: string;
             value_template: string;
-            path?: string | undefined;
             domain?: string | undefined;
+            path?: string | undefined;
         }, {
             name: string;
-            path?: string | undefined;
-            domain?: string | undefined;
             value_template?: string | undefined;
+            domain?: string | undefined;
+            path?: string | undefined;
         }>, "many">>;
     }, "strict", z.ZodTypeAny, {
-        cookies?: {
-            name: string;
-            value_template: string;
-            path?: string | undefined;
-            domain?: string | undefined;
-        }[] | undefined;
         localStorage?: {
             key: string;
             value_template: string;
         }[] | undefined;
-    }, {
         cookies?: {
             name: string;
-            path?: string | undefined;
+            value_template: string;
             domain?: string | undefined;
-            value_template?: string | undefined;
+            path?: string | undefined;
         }[] | undefined;
+    }, {
         localStorage?: {
             key: string;
             value_template?: string | undefined;
         }[] | undefined;
-    }>, {
         cookies?: {
             name: string;
-            value_template: string;
-            path?: string | undefined;
+            value_template?: string | undefined;
             domain?: string | undefined;
+            path?: string | undefined;
         }[] | undefined;
+    }>, {
         localStorage?: {
             key: string;
             value_template: string;
         }[] | undefined;
-    }, {
         cookies?: {
             name: string;
-            path?: string | undefined;
+            value_template: string;
             domain?: string | undefined;
-            value_template?: string | undefined;
+            path?: string | undefined;
         }[] | undefined;
+    }, {
         localStorage?: {
             key: string;
             value_template?: string | undefined;
         }[] | undefined;
-    }>;
-}, "strict", z.ZodTypeAny, {
-    inject: {
         cookies?: {
             name: string;
-            value_template: string;
-            path?: string | undefined;
+            value_template?: string | undefined;
             domain?: string | undefined;
+            path?: string | undefined;
         }[] | undefined;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    token_env?: string | undefined;
+    token_url?: string | undefined;
+    inject: {
         localStorage?: {
             key: string;
             value_template: string;
         }[] | undefined;
-    };
-    token_env?: string | undefined;
-    token_url?: string | undefined;
-}, {
-    inject: {
         cookies?: {
             name: string;
-            path?: string | undefined;
+            value_template: string;
             domain?: string | undefined;
-            value_template?: string | undefined;
+            path?: string | undefined;
         }[] | undefined;
+    };
+}, {
+    token_env?: string | undefined;
+    token_url?: string | undefined;
+    inject: {
         localStorage?: {
             key: string;
             value_template?: string | undefined;
         }[] | undefined;
+        cookies?: {
+            name: string;
+            value_template?: string | undefined;
+            domain?: string | undefined;
+            path?: string | undefined;
+        }[] | undefined;
     };
+}>, {
     token_env?: string | undefined;
     token_url?: string | undefined;
-}>, {
     inject: {
+        localStorage?: {
+            key: string;
+            value_template: string;
+        }[] | undefined;
         cookies?: {
             name: string;
             value_template: string;
-            path?: string | undefined;
             domain?: string | undefined;
-        }[] | undefined;
-        localStorage?: {
-            key: string;
-            value_template: string;
+            path?: string | undefined;
         }[] | undefined;
     };
+}, {
     token_env?: string | undefined;
     token_url?: string | undefined;
-}, {
     inject: {
-        cookies?: {
-            name: string;
-            path?: string | undefined;
-            domain?: string | undefined;
-            value_template?: string | undefined;
-        }[] | undefined;
         localStorage?: {
             key: string;
             value_template?: string | undefined;
         }[] | undefined;
+        cookies?: {
+            name: string;
+            value_template?: string | undefined;
+            domain?: string | undefined;
+            path?: string | undefined;
+        }[] | undefined;
     };
-    token_env?: string | undefined;
-    token_url?: string | undefined;
 }>;
 export type JwtInjectionOptions = z.infer<typeof JwtInjectionOptions>;
 /** Decode a JWT's payload (base64url, **no signature verification**) — claims-reading only. */

package/dist/auth/pat-header.d.ts

@@ -6,11 +6,11 @@ export declare const PatHeaderOptions: z.ZodObject<{
     /** `{{token}}` template for the header value. Default `Bearer {{token}}`. */
     value_template: z.ZodDefault<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
-    value_template: string;
     header: string;
+    value_template: string;
 }, {
-    value_template?: string | undefined;
     header?: string | undefined;
+    value_template?: string | undefined;
 }>;
 export type PatHeaderOptions = z.infer<typeof PatHeaderOptions>;
 export declare class PatHeaderStrategy implements AuthStrategy {

package/dist/auth/types.d.ts

@@ -71,8 +71,8 @@ export declare class NotImplementedStrategyError extends Error {
     constructor(name: string);
 }
 export declare class AuthStrategyConfigError extends Error {
-    readonly cause?: unknown | undefined;
-    constructor(message: string, cause?: unknown | undefined);
+    readonly cause?: unknown;
+    constructor(message: string, cause?: unknown);
 }
 /** Validate a strategy's `options` record against its schema; config errors name the offending key, never values. */
 export declare function parseStrategyOptions<S extends z.ZodTypeAny>(strategy: string, schema: S, options: Record<string, unknown>): z.infer<S>;

package/dist/auth/ui-form.d.ts

@@ -8,12 +8,12 @@ export declare const PreStep: z.ZodObject<{
     /** Env var *name* holding the fill value (required for `fill`). */
     value_env: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
+    action: "click" | "fill";
     selector: string;
-    action: "fill" | "click";
     value_env?: string | undefined;
 }, {
+    action: "click" | "fill";
     selector: string;
-    action: "fill" | "click";
     value_env?: string | undefined;
 }>;
 export type PreStep = z.infer<typeof PreStep>;
@@ -32,19 +32,19 @@ export declare const UiFormTotpOptions: z.ZodObject<{
     period: z.ZodDefault<z.ZodNumber>;
     algorithm: z.ZodDefault<z.ZodEnum<["sha1", "sha256"]>>;
 }, "strict", z.ZodTypeAny, {
-    digits: 8 | 6;
-    period: number;
-    algorithm: "sha1" | "sha256";
     secret_env: string;
     otp_selector: string;
     submit_selector?: string | undefined;
+    digits: 6 | 8;
+    period: number;
+    algorithm: "sha1" | "sha256";
 }, {
     secret_env: string;
     otp_selector: string;
-    digits?: 8 | 6 | undefined;
+    submit_selector?: string | undefined;
+    digits?: 6 | 8 | undefined;
     period?: number | undefined;
     algorithm?: "sha1" | "sha256" | undefined;
-    submit_selector?: string | undefined;
 }>;
 export type UiFormTotpOptions = z.infer<typeof UiFormTotpOptions>;
 export declare const UiFormOptions: z.ZodEffects<z.ZodObject<{
@@ -67,12 +67,12 @@ export declare const UiFormOptions: z.ZodEffects<z.ZodObject<{
         /** Env var *name* holding the fill value (required for `fill`). */
         value_env: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
+        action: "click" | "fill";
         selector: string;
-        action: "fill" | "click";
         value_env?: string | undefined;
     }, {
+        action: "click" | "fill";
         selector: string;
-        action: "fill" | "click";
         value_env?: string | undefined;
     }>, "many">>;
     totp: z.ZodOptional<z.ZodObject<{
@@ -84,108 +84,108 @@ export declare const UiFormOptions: z.ZodEffects<z.ZodObject<{
         period: z.ZodDefault<z.ZodNumber>;
         algorithm: z.ZodDefault<z.ZodEnum<["sha1", "sha256"]>>;
     }, "strict", z.ZodTypeAny, {
-        digits: 8 | 6;
-        period: number;
-        algorithm: "sha1" | "sha256";
         secret_env: string;
         otp_selector: string;
         submit_selector?: string | undefined;
+        digits: 6 | 8;
+        period: number;
+        algorithm: "sha1" | "sha256";
     }, {
         secret_env: string;
         otp_selector: string;
-        digits?: 8 | 6 | undefined;
+        submit_selector?: string | undefined;
+        digits?: 6 | 8 | undefined;
         period?: number | undefined;
         algorithm?: "sha1" | "sha256" | undefined;
-        submit_selector?: string | undefined;
     }>>;
 }, "strict", z.ZodTypeAny, {
-    timeout_ms: number;
     login_url: string;
-    ignore_https_errors: boolean;
-    submit_selector: string;
     username_selector: string;
     password_selector: string;
+    submit_selector: string;
+    success_selector?: string | undefined;
+    url_matches?: string | undefined;
+    timeout_ms: number;
+    ignore_https_errors: boolean;
     pre_steps: {
+        action: "click" | "fill";
         selector: string;
-        action: "fill" | "click";
         value_env?: string | undefined;
     }[];
-    url_matches?: string | undefined;
     totp?: {
-        digits: 8 | 6;
-        period: number;
-        algorithm: "sha1" | "sha256";
         secret_env: string;
         otp_selector: string;
         submit_selector?: string | undefined;
+        digits: 6 | 8;
+        period: number;
+        algorithm: "sha1" | "sha256";
     } | undefined;
-    success_selector?: string | undefined;
 }, {
     login_url: string;
-    submit_selector: string;
     username_selector: string;
     password_selector: string;
-    timeout_ms?: number | undefined;
+    submit_selector: string;
+    success_selector?: string | undefined;
     url_matches?: string | undefined;
+    timeout_ms?: number | undefined;
+    ignore_https_errors?: boolean | undefined;
+    pre_steps?: {
+        action: "click" | "fill";
+        selector: string;
+        value_env?: string | undefined;
+    }[] | undefined;
     totp?: {
         secret_env: string;
         otp_selector: string;
-        digits?: 8 | 6 | undefined;
+        submit_selector?: string | undefined;
+        digits?: 6 | 8 | undefined;
         period?: number | undefined;
         algorithm?: "sha1" | "sha256" | undefined;
-        submit_selector?: string | undefined;
     } | undefined;
-    ignore_https_errors?: boolean | undefined;
-    success_selector?: string | undefined;
-    pre_steps?: {
-        selector: string;
-        action: "fill" | "click";
-        value_env?: string | undefined;
-    }[] | undefined;
 }>, {
-    timeout_ms: number;
     login_url: string;
-    ignore_https_errors: boolean;
-    submit_selector: string;
     username_selector: string;
     password_selector: string;
+    submit_selector: string;
+    success_selector?: string | undefined;
+    url_matches?: string | undefined;
+    timeout_ms: number;
+    ignore_https_errors: boolean;
     pre_steps: {
+        action: "click" | "fill";
         selector: string;
-        action: "fill" | "click";
         value_env?: string | undefined;
     }[];
-    url_matches?: string | undefined;
     totp?: {
-        digits: 8 | 6;
-        period: number;
-        algorithm: "sha1" | "sha256";
         secret_env: string;
         otp_selector: string;
         submit_selector?: string | undefined;
+        digits: 6 | 8;
+        period: number;
+        algorithm: "sha1" | "sha256";
     } | undefined;
-    success_selector?: string | undefined;
 }, {
     login_url: string;
-    submit_selector: string;
     username_selector: string;
     password_selector: string;
-    timeout_ms?: number | undefined;
+    submit_selector: string;
+    success_selector?: string | undefined;
     url_matches?: string | undefined;
+    timeout_ms?: number | undefined;
+    ignore_https_errors?: boolean | undefined;
+    pre_steps?: {
+        action: "click" | "fill";
+        selector: string;
+        value_env?: string | undefined;
+    }[] | undefined;
     totp?: {
         secret_env: string;
         otp_selector: string;
-        digits?: 8 | 6 | undefined;
+        submit_selector?: string | undefined;
+        digits?: 6 | 8 | undefined;
         period?: number | undefined;
         algorithm?: "sha1" | "sha256" | undefined;
-        submit_selector?: string | undefined;
     } | undefined;
-    ignore_https_errors?: boolean | undefined;
-    success_selector?: string | undefined;
-    pre_steps?: {
-        selector: string;
-        action: "fill" | "click";
-        value_env?: string | undefined;
-    }[] | undefined;
 }>;
 export type UiFormOptions = z.infer<typeof UiFormOptions>;
 export declare class UiFormStrategy implements AuthStrategy {