@samsara-dev/appwright 0.9.5 → 0.9.7

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # appwright
 
+## 0.9.7
+
+### Patch Changes
+
+- dbd26ca: feat(gptDriver): integrate GPT Driver SDK for AI-powered test automation
+
+  Add GPT Driver SDK integration enabling natural language test automation via `device.gptDriver.*` methods:
+  - `aiExecute(instruction)` - execute AI-powered actions
+  - `assert(condition)` - verify screen state with natural language
+  - `assertBulk(conditions)` - verify multiple conditions at once
+  - `checkBulk(conditions)` - check conditions without failing test
+  - `extract(extractions)` - extract data from screen
+
+  Requires `GPT_DRIVER_API_KEY` environment variable. Tests gracefully skip when not configured.
+
+## 0.9.6
+
+### Patch Changes
+
+- b6c5799: Add configurable Appium settings for emulator/local devices via `AppiumSettings`
+  (`waitForIdleTimeout`, `newCommandTimeout`, `snapshotMaxDepth`,
+  `waitForSelectorTimeout`, `actionAcknowledgmentTimeout`, `ignoreUnimportantViews`,
+  `customSnapshotTimeout`, `waitForQuiescence`, `animationCoolOffTimeout`,
+  `reduceMotion`, `snapshotTimeout`, `includeSafariInWebviews`,
+  `chromedriverAutodownload`) to tune Android/iOS behavior for apps that never
+  become idle.
+
+  BrowserStack adds geolocation, Appium updateSettings tuning, and a video
+  download opt-out that also skips waits when downloads are disabled.
+
 ## 0.9.5
 
 ### Patch Changes

package/README.md

@@ -234,6 +234,40 @@ npm run extract:app
 npx appwright test --project ios
 ```
 
+## GPT Driver Integration
+
+Appwright supports [GPT Driver](https://docs.mobileboost.io/gpt-driver-sdk) for AI-powered test automation. This enables natural language commands and AI assertions.
+
+### Setup
+
+Set the `GPT_DRIVER_API_KEY` environment variable:
+
+```sh
+export GPT_DRIVER_API_KEY=your-api-key
+```
+
+### Usage
+
+```ts
+import { test } from "@samsara-dev/appwright";
+
+test("User can add item to cart", async ({ device }) => {
+  // Natural language commands
+  await device.gptDriver.aiExecute("tap on the login button");
+  await device.gptDriver.aiExecute("enter 'admin' in the username field");
+
+  // AI-powered assertions
+  await device.gptDriver.assert("welcome message is visible");
+  await device.gptDriver.assert("cart shows 1 item");
+});
+```
+
+### Data Privacy Notice
+
+GPT Driver sends screenshots to Mobileboost's external API for AI processing. Do not use GPT Driver in tests that handle sensitive data displayed on screen.
+
+Tests skip automatically when `GPT_DRIVER_API_KEY` is not set.
+
 ## Docs
 
 - [Basics](docs/basics.md)

package/dist/device/index.d.ts

@@ -16,6 +16,7 @@ export declare class Device {
     private persistentSyncEnabled;
     private activePersistentKey?;
     private cleanupCallback?;
+    private _gptDriverProvider;
     constructor(webDriverClient: WebDriverClient, bundleId: string | undefined, timeoutOpts: TimeoutOptions, provider: string, deviceProvider?: DeviceProvider, cleanupCallback?: () => Promise<void>);
     attachDeviceProvider(provider: DeviceProvider): void;
     enablePersistentStatusSync(): void;
@@ -60,6 +61,29 @@ export declare class Device {
             };
         }) => Promise<ExtractType<T>>;
     };
+    private gptDriverProvider;
+    /**
+     * GPT Driver AI-powered test automation.
+     * Requires GPT_DRIVER_API_KEY environment variable.
+     *
+     * Note: Screenshots are sent to GPT Driver's external API for AI processing.
+     *
+     * **Usage:**
+     * ```js
+     * await device.gptDriver.aiExecute("tap on the login button");
+     * await device.gptDriver.assert("welcome message is visible");
+     * await device.gptDriver.assertBulk(["button is visible", "text shows 'Hello'"]);
+     * const results = await device.gptDriver.checkBulk(["logged in", "menu open"]);
+     * const data = await device.gptDriver.extract(["total price", "item count"]);
+     * ```
+     */
+    gptDriver: {
+        aiExecute: (instruction: string) => Promise<void>;
+        assert: (condition: string) => Promise<void>;
+        assertBulk: (conditions: string[]) => Promise<void>;
+        checkBulk: (conditions: string[]) => Promise<Record<string, boolean>>;
+        extract: (extractions: string[]) => Promise<Record<string, any>>;
+    };
     /**
      * Closes the automation session. This is called automatically after each test.
      *

package/dist/device/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/device/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,WAAW,CAAC;AAE3D,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,cAAc,EACd,qBAAqB,EACrB,QAAQ,EACR,cAAc,EACd,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAKlB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAO7C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,KAAK,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7E,qBAAa,MAAM;IAQf,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,QAAQ;IAVlB,OAAO,CAAC,kBAAkB,CAAC,CAAqB;IAChD,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,qBAAqB,CAAS;IACtC,OAAO,CAAC,mBAAmB,CAAC,CAAS;IACrC,OAAO,CAAC,eAAe,CAAC,CAAsB;gBAGpC,eAAe,EAAE,eAAe,EAChC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,WAAW,EAAE,cAAc,EAC3B,QAAQ,EAAE,MAAM,EACxB,cAAc,CAAC,EAAE,cAAc,EAC/B,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC;IAMvC,oBAAoB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAIpD,0BAA0B,IAAI,IAAI;IAI5B,yBAAyB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5D,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAYxD,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB/D,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,aAAa;YAQP,QAAQ;IAetB;;OAEG;IACH,qBAAqB,CACnB,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,iBAAiB,GACzB,IAAI;IAQP;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAKvC,OAAO,CAAC,EACN,QAAQ,EACR,YAAY,EACZ,WAAW,GACZ,EAAE;QACD,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;KAC/B,GAAG,gBAAgB;IAWpB,OAAO,CAAC,MAAM;IAId,IAAI;sBAEQ,MAAM,YACJ;YACR,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,SAAS,CAAC,EAAE;gBACV,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;aACjB,CAAC;SACH,KACA,OAAO,CAAC;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;gBAItB,CAAC,SAAS,CAAC,CAAC,OAAO,UACvB,MAAM,YACJ;YACR,cAAc,CAAC,EAAE,CAAC,CAAC;YACnB,KAAK,CAAC,EAAE,QAAQ,CAAC;YACjB,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,SAAS,CAAC,EAAE;gBACV,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;aACjB,CAAC;SACH,KACA,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;MAG1B;IAEF;;;;;;;OAOG;IACG,KAAK;IA0BX;;;;;;;;;;;OAWG;IAEG,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE;IAoB5C;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,CACP,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,EAAE,KAAa,EAAE,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GAC1C,gBAAgB;IAsCnB;;;;;;;;;;;;OAYG;IACH,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,EAAE,KAAa,EAAE,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GAC1C,gBAAgB;IAiBnB;;;;;;;;;;;OAWG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB;IAS1C,OAAO,CAAC,iBAAiB;IAczB;;;;;;;;;;OAUG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB;IAI3C;;;;;;;;;OASG;IACH,WAAW,IAAI,QAAQ;IAMjB,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM;IAc9B,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM;IAanC;;;;;;;;;;;;;;;;;OAiBG;IAEG,aAAa,CAAC,OAAO,GAAE,MAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxD;;;;;;;;;;OAUG;IAEG,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAqBzC;;;;;;;;;;;OAWG;IAEG,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBnD,KAAK;IAkBL,cAAc,CAAC,OAAO,EAAE,MAAM;IAIpC;;OAEG;IAEG,WAAW,IAAI,OAAO,CAAC,cAAc,CAAC;IAI5C;;OAEG;IAEG,aAAa,IAAI,OAAO,CAAC;QAC7B,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;KACX,CAAC;IAIF;;OAEG;IAEG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAInC;;;;;;;;;;OAUG;IAEG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAU7B;;;OAGG;IAEG,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBlD;;;;;;;;;;;;;;;;;OAiBG;IAEU,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAYnE;;;;;;;;;;;;;OAaG;IAEU,wBAAwB,CACnC,QAAQ,EAAE,qBAAqB,GAC9B,OAAO,CAAC,IAAI,CAAC;IAIhB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;CAe9B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/device/index.ts"],"names":[],"mappings":"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"}

package/dist/device/index.js

@@ -38,6 +38,7 @@ exports.Device = void 0;
 const locator_1 = require("../locator");
 const types_1 = require("../types");
 const vision_1 = require("../vision");
+const gptDriver_1 = require("../gptDriver");
 const utils_1 = require("../utils");
 const utils_2 = require("../providers/browserstack/utils");
 const utils_3 = require("../providers/lambdatest/utils");
@@ -104,6 +105,7 @@ let Device = (() => {
         persistentSyncEnabled = false;
         activePersistentKey;
         cleanupCallback;
+        _gptDriverProvider = null;
         constructor(webDriverClient, bundleId, timeoutOpts, provider, deviceProvider, cleanupCallback) {
             this.webDriverClient = webDriverClient;
             this.bundleId = bundleId;
@@ -219,6 +221,44 @@ let Device = (() => {
                 return await this.vision().query(prompt, options);
             },
         };
+        gptDriverProvider() {
+            if (!this._gptDriverProvider) {
+                this._gptDriverProvider = new gptDriver_1.GptDriverProvider(this.webDriverClient);
+            }
+            return this._gptDriverProvider;
+        }
+        /**
+         * GPT Driver AI-powered test automation.
+         * Requires GPT_DRIVER_API_KEY environment variable.
+         *
+         * Note: Screenshots are sent to GPT Driver's external API for AI processing.
+         *
+         * **Usage:**
+         * ```js
+         * await device.gptDriver.aiExecute("tap on the login button");
+         * await device.gptDriver.assert("welcome message is visible");
+         * await device.gptDriver.assertBulk(["button is visible", "text shows 'Hello'"]);
+         * const results = await device.gptDriver.checkBulk(["logged in", "menu open"]);
+         * const data = await device.gptDriver.extract(["total price", "item count"]);
+         * ```
+         */
+        gptDriver = {
+            aiExecute: async (instruction) => {
+                return await this.gptDriverProvider().aiExecute(instruction);
+            },
+            assert: async (condition) => {
+                return await this.gptDriverProvider().assert(condition);
+            },
+            assertBulk: async (conditions) => {
+                return await this.gptDriverProvider().assertBulk(conditions);
+            },
+            checkBulk: async (conditions) => {
+                return await this.gptDriverProvider().checkBulk(conditions);
+            },
+            extract: async (extractions) => {
+                return await this.gptDriverProvider().extract(extractions);
+            },
+        };
         /**
          * Closes the automation session. This is called automatically after each test.
          *

package/dist/gptDriver/index.d.ts

@@ -0,0 +1,38 @@
+import type { Client as WebDriverClient } from "webdriver";
+/**
+ * GptDriverApi defines the public interface for AI-powered test automation.
+ */
+export interface GptDriverApi {
+    aiExecute(instruction: string): Promise<void>;
+    assert(condition: string): Promise<void>;
+    assertBulk(conditions: string[]): Promise<void>;
+    checkBulk(conditions: string[]): Promise<Record<string, boolean>>;
+    extract(extractions: string[]): Promise<Record<string, any>>;
+}
+/**
+ * GptDriverProvider wraps the gpt-driver-node SDK for AI-powered test automation.
+ *
+ * Pattern: Lazy-initialized singleton per Device instance.
+ * - Driver is created on first use (not in constructor)
+ * - Cached for subsequent calls
+ * - Gracefully skips tests when API key is not configured
+ *
+ * Similar to: VisionProvider
+ */
+export declare class GptDriverProvider implements GptDriverApi {
+    private webDriverClient;
+    private driver;
+    constructor(webDriverClient: WebDriverClient);
+    private getAppiumUrl;
+    private getDriver;
+    private requireDriver;
+    private validateInstruction;
+    private validateConditions;
+    private sanitizeError;
+    aiExecute(instruction: string): Promise<void>;
+    assert(condition: string): Promise<void>;
+    assertBulk(conditions: string[]): Promise<void>;
+    checkBulk(conditions: string[]): Promise<Record<string, boolean>>;
+    extract(extractions: string[]): Promise<Record<string, any>>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/gptDriver/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/gptDriver/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,WAAW,CAAC;AAM3D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAClE,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;CAC9D;AAED;;;;;;;;;GASG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IAGxC,OAAO,CAAC,eAAe;IAFnC,OAAO,CAAC,MAAM,CAA0B;gBAEpB,eAAe,EAAE,eAAe;IAEpD,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,SAAS;IAuBjB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,aAAa;IAMf,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa7C,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAaxC,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAa/C,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAajE,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAWnE"}

package/dist/gptDriver/index.js

@@ -0,0 +1,187 @@
+"use strict";
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GptDriverProvider = void 0;
+const gpt_driver_node_1 = __importDefault(require("gpt-driver-node"));
+const utils_1 = require("../utils");
+const test_1 = __importDefault(require("@playwright/test"));
+const MAX_INSTRUCTION_LENGTH = 10000;
+/**
+ * GptDriverProvider wraps the gpt-driver-node SDK for AI-powered test automation.
+ *
+ * Pattern: Lazy-initialized singleton per Device instance.
+ * - Driver is created on first use (not in constructor)
+ * - Cached for subsequent calls
+ * - Gracefully skips tests when API key is not configured
+ *
+ * Similar to: VisionProvider
+ */
+let GptDriverProvider = (() => {
+    let _instanceExtraInitializers = [];
+    let _aiExecute_decorators;
+    let _assert_decorators;
+    let _assertBulk_decorators;
+    let _checkBulk_decorators;
+    let _extract_decorators;
+    return class GptDriverProvider {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _aiExecute_decorators = [utils_1.boxedStep];
+            _assert_decorators = [utils_1.boxedStep];
+            _assertBulk_decorators = [utils_1.boxedStep];
+            _checkBulk_decorators = [utils_1.boxedStep];
+            _extract_decorators = [utils_1.boxedStep];
+            __esDecorate(this, null, _aiExecute_decorators, { kind: "method", name: "aiExecute", static: false, private: false, access: { has: obj => "aiExecute" in obj, get: obj => obj.aiExecute }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _assert_decorators, { kind: "method", name: "assert", static: false, private: false, access: { has: obj => "assert" in obj, get: obj => obj.assert }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _assertBulk_decorators, { kind: "method", name: "assertBulk", static: false, private: false, access: { has: obj => "assertBulk" in obj, get: obj => obj.assertBulk }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _checkBulk_decorators, { kind: "method", name: "checkBulk", static: false, private: false, access: { has: obj => "checkBulk" in obj, get: obj => obj.checkBulk }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _extract_decorators, { kind: "method", name: "extract", static: false, private: false, access: { has: obj => "extract" in obj, get: obj => obj.extract }, metadata: _metadata }, null, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        webDriverClient = __runInitializers(this, _instanceExtraInitializers);
+        driver = null;
+        constructor(webDriverClient) {
+            this.webDriverClient = webDriverClient;
+        }
+        getAppiumUrl() {
+            const { protocol, hostname, port, path, user, key } = this.webDriverClient.options;
+            // Include basic auth for cloud providers (BrowserStack, LambdaTest)
+            const auth = user && key ? `${user}:${key}@` : "";
+            return `${protocol}://${auth}${hostname}:${port}${path}`;
+        }
+        getDriver() {
+            if (this.driver)
+                return this.driver;
+            const apiKey = process.env.GPT_DRIVER_API_KEY;
+            if (!apiKey) {
+                console.debug("[GptDriver] GPT_DRIVER_API_KEY not set, GPT Driver features disabled");
+                return null;
+            }
+            this.driver = new gpt_driver_node_1.default({
+                apiKey,
+                // gpt-driver-node expects webdriverio Browser type but webdriver Client is API-compatible at runtime
+                driver: this.webDriverClient,
+                serverConfig: { url: this.getAppiumUrl() },
+                cachingMode: "FULL_SCREEN",
+                testId: test_1.default.info()?.testId ?? `test-${Date.now()}`,
+            });
+            console.debug("[GptDriver] Initialized successfully");
+            return this.driver;
+        }
+        requireDriver() {
+            const driver = this.getDriver();
+            if (!driver) {
+                test_1.default.skip(true, "GPT Driver not configured. Set GPT_DRIVER_API_KEY environment variable.");
+                throw new Error("GPT Driver not configured");
+            }
+            return driver;
+        }
+        validateInstruction(instruction, methodName) {
+            if (!instruction || typeof instruction !== "string") {
+                throw new Error(`${methodName} requires a non-empty instruction string`);
+            }
+            if (instruction.length > MAX_INSTRUCTION_LENGTH) {
+                throw new Error(`${methodName} instruction exceeds maximum length of ${MAX_INSTRUCTION_LENGTH}`);
+            }
+        }
+        validateConditions(conditions, methodName) {
+            if (!Array.isArray(conditions) || conditions.length === 0) {
+                throw new Error(`${methodName} requires a non-empty array of conditions`);
+            }
+            for (const condition of conditions) {
+                this.validateInstruction(condition, methodName);
+            }
+        }
+        sanitizeError(error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return message.replace(/[a-zA-Z0-9]{32,}/g, "[REDACTED]");
+        }
+        async aiExecute(instruction) {
+            this.validateInstruction(instruction, "aiExecute");
+            const driver = this.requireDriver();
+            try {
+                await driver.aiExecute(instruction);
+            }
+            catch (error) {
+                throw new Error(`GPT Driver aiExecute failed: ${this.sanitizeError(error)}`);
+            }
+        }
+        async assert(condition) {
+            this.validateInstruction(condition, "assert");
+            const driver = this.requireDriver();
+            try {
+                await driver.assert(condition, {});
+            }
+            catch (error) {
+                throw new Error(`GPT Driver assertion failed: ${this.sanitizeError(error)}`);
+            }
+        }
+        async assertBulk(conditions) {
+            this.validateConditions(conditions, "assertBulk");
+            const driver = this.requireDriver();
+            try {
+                await driver.assertBulk(conditions, {});
+            }
+            catch (error) {
+                throw new Error(`GPT Driver assertBulk failed: ${this.sanitizeError(error)}`);
+            }
+        }
+        async checkBulk(conditions) {
+            this.validateConditions(conditions, "checkBulk");
+            const driver = this.requireDriver();
+            try {
+                return await driver.checkBulk(conditions);
+            }
+            catch (error) {
+                throw new Error(`GPT Driver checkBulk failed: ${this.sanitizeError(error)}`);
+            }
+        }
+        async extract(extractions) {
+            this.validateConditions(extractions, "extract");
+            const driver = this.requireDriver();
+            try {
+                return await driver.extract(extractions);
+            }
+            catch (error) {
+                throw new Error(`GPT Driver extract failed: ${this.sanitizeError(error)}`);
+            }
+        }
+    };
+})();
+exports.GptDriverProvider = GptDriverProvider;

package/dist/providers/appiumSettings.d.ts

@@ -0,0 +1,10 @@
+import { AppiumSettings, Platform } from "../types";
+type AppiumCapabilities = Record<string, unknown>;
+type AppiumSettingsOptions = {
+    includeBrowserStackSettings?: boolean;
+    includeUpdateSettingsCapabilities?: boolean;
+};
+export declare function buildAppiumUpdateSettings(appiumSettings: AppiumSettings | undefined, platformName: Platform | undefined): Record<string, unknown> | undefined;
+export declare function applyAppiumSettingsToCapabilities(capabilities: AppiumCapabilities, appiumSettings: AppiumSettings | undefined, platformName: Platform | undefined, options?: AppiumSettingsOptions): void;
+export {};
+//# sourceMappingURL=appiumSettings.d.ts.map

package/dist/providers/appiumSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appiumSettings.d.ts","sourceRoot":"","sources":["../../src/providers/appiumSettings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpD,KAAK,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAElD,KAAK,qBAAqB,GAAG;IAC3B,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,iCAAiC,CAAC,EAAE,OAAO,CAAC;CAC7C,CAAC;AAEF,wBAAgB,yBAAyB,CACvC,cAAc,EAAE,cAAc,GAAG,SAAS,EAC1C,YAAY,EAAE,QAAQ,GAAG,SAAS,uCA4CnC;AAED,wBAAgB,iCAAiC,CAC/C,YAAY,EAAE,kBAAkB,EAChC,cAAc,EAAE,cAAc,GAAG,SAAS,EAC1C,YAAY,EAAE,QAAQ,GAAG,SAAS,EAClC,OAAO,GAAE,qBAA0B,QAqFpC"}

package/dist/providers/appiumSettings.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAppiumUpdateSettings = buildAppiumUpdateSettings;
+exports.applyAppiumSettingsToCapabilities = applyAppiumSettingsToCapabilities;
+const types_1 = require("../types");
+function buildAppiumUpdateSettings(appiumSettings, platformName) {
+    if (!appiumSettings) {
+        return undefined;
+    }
+    const settings = {};
+    const includeAndroidSettings = platformName === types_1.Platform.ANDROID || platformName === undefined;
+    const includeIosSettings = platformName === types_1.Platform.IOS || platformName === undefined;
+    if (includeAndroidSettings) {
+        if (appiumSettings.snapshotMaxDepth !== undefined) {
+            settings.snapshotMaxDepth = appiumSettings.snapshotMaxDepth;
+        }
+        if (appiumSettings.waitForIdleTimeout !== undefined) {
+            settings.waitForIdleTimeout = appiumSettings.waitForIdleTimeout;
+        }
+        if (appiumSettings.waitForSelectorTimeout !== undefined) {
+            settings.waitForSelectorTimeout = appiumSettings.waitForSelectorTimeout;
+        }
+        if (appiumSettings.actionAcknowledgmentTimeout !== undefined) {
+            settings.actionAcknowledgmentTimeout =
+                appiumSettings.actionAcknowledgmentTimeout;
+        }
+        if (appiumSettings.ignoreUnimportantViews !== undefined) {
+            settings.ignoreUnimportantViews = appiumSettings.ignoreUnimportantViews;
+        }
+        if (appiumSettings.customSnapshotTimeout !== undefined) {
+            settings.customSnapshotTimeout = appiumSettings.customSnapshotTimeout;
+        }
+    }
+    if (includeIosSettings) {
+        if (appiumSettings.snapshotTimeout !== undefined) {
+            settings.snapshotTimeout = appiumSettings.snapshotTimeout;
+        }
+        if (appiumSettings.waitForQuiescence !== undefined) {
+            settings.shouldWaitForQuiescence = appiumSettings.waitForQuiescence;
+        }
+    }
+    return Object.keys(settings).length > 0 ? settings : undefined;
+}
+function applyAppiumSettingsToCapabilities(capabilities, appiumSettings, platformName, options = {}) {
+    if (!appiumSettings) {
+        return;
+    }
+    const includeUpdateSettingsCapabilities = options.includeUpdateSettingsCapabilities !== false;
+    if (includeUpdateSettingsCapabilities && platformName === types_1.Platform.ANDROID) {
+        if (appiumSettings.snapshotMaxDepth !== undefined) {
+            capabilities["appium:settings[snapshotMaxDepth]"] =
+                appiumSettings.snapshotMaxDepth;
+        }
+    }
+    if (appiumSettings.newCommandTimeout !== undefined) {
+        capabilities["appium:newCommandTimeout"] = appiumSettings.newCommandTimeout;
+    }
+    if (platformName === types_1.Platform.ANDROID) {
+        if (includeUpdateSettingsCapabilities) {
+            if (appiumSettings.waitForIdleTimeout !== undefined) {
+                capabilities["appium:settings[waitForIdleTimeout]"] =
+                    appiumSettings.waitForIdleTimeout;
+            }
+            if (appiumSettings.waitForSelectorTimeout !== undefined) {
+                capabilities["appium:settings[waitForSelectorTimeout]"] =
+                    appiumSettings.waitForSelectorTimeout;
+            }
+            if (appiumSettings.actionAcknowledgmentTimeout !== undefined) {
+                capabilities["appium:settings[actionAcknowledgmentTimeout]"] =
+                    appiumSettings.actionAcknowledgmentTimeout;
+            }
+            if (appiumSettings.ignoreUnimportantViews !== undefined) {
+                capabilities["appium:settings[ignoreUnimportantViews]"] =
+                    appiumSettings.ignoreUnimportantViews;
+            }
+            if (appiumSettings.customSnapshotTimeout !== undefined) {
+                capabilities["appium:settings[customSnapshotTimeout]"] =
+                    appiumSettings.customSnapshotTimeout;
+            }
+        }
+        if (appiumSettings.disableWindowAnimation !== undefined) {
+            capabilities["appium:disableWindowAnimation"] =
+                appiumSettings.disableWindowAnimation;
+        }
+        if (appiumSettings.skipDeviceInitialization !== undefined) {
+            capabilities["appium:skipDeviceInitialization"] =
+                appiumSettings.skipDeviceInitialization;
+        }
+        if (appiumSettings.chromedriverAutodownload !== undefined) {
+            capabilities["appium:chromedriverAutodownload"] =
+                appiumSettings.chromedriverAutodownload;
+        }
+    }
+    if (platformName === types_1.Platform.IOS) {
+        if (includeUpdateSettingsCapabilities) {
+            if (appiumSettings.waitForQuiescence !== undefined) {
+                capabilities["appium:settings[shouldWaitForQuiescence]"] =
+                    appiumSettings.waitForQuiescence;
+            }
+        }
+        if (appiumSettings.animationCoolOffTimeout !== undefined) {
+            capabilities["appium:animationCoolOffTimeout"] =
+                appiumSettings.animationCoolOffTimeout;
+        }
+        if (appiumSettings.reduceMotion !== undefined) {
+            capabilities["appium:reduceMotion"] = appiumSettings.reduceMotion;
+        }
+        if (includeUpdateSettingsCapabilities) {
+            if (appiumSettings.snapshotTimeout !== undefined) {
+                capabilities["appium:settings[snapshotTimeout]"] =
+                    appiumSettings.snapshotTimeout;
+            }
+        }
+        if (appiumSettings.includeSafariInWebviews !== undefined) {
+            capabilities["appium:includeSafariInWebviews"] =
+                appiumSettings.includeSafariInWebviews;
+        }
+    }
+    if (options.includeBrowserStackSettings && appiumSettings.bstackPageSource) {
+        capabilities["appium:bstackPageSource"] = appiumSettings.bstackPageSource;
+    }
+}

package/dist/providers/browserstack/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/browserstack/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,eAAe,EACf,cAAc,EAGf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAsDtC,qBAAa,0BAA2B,YAAW,cAAc;IAC/D,OAAO,CAAC,cAAc,CAAC,CAA6B;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,OAAO,CAA+B;gBAG5C,OAAO,EAAE,WAAW,CAAC,eAAe,CAAC,EACrC,WAAW,EAAE,MAAM,GAAG,SAAS;IAU3B,WAAW;IA0EX,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAMlC,OAAO,CAAC,cAAc;YASR,YAAY;YAiBZ,iBAAiB;YAKjB,yBAAyB;WAK1B,aAAa,CACxB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAyFlD,eAAe,CAAC,OAAO,EAAE;QAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf;IA2BD,OAAO,CAAC,YAAY;CAsJrB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/browserstack/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,eAAe,EACf,cAAc,EAGf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AA0DtC,qBAAa,0BAA2B,YAAW,cAAc;IAC/D,OAAO,CAAC,cAAc,CAAC,CAA6B;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,OAAO,CAA+B;gBAG5C,OAAO,EAAE,WAAW,CAAC,eAAe,CAAC,EACrC,WAAW,EAAE,MAAM,GAAG,SAAS;IAU3B,WAAW;IA0EX,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAMlC,OAAO,CAAC,cAAc;YASR,YAAY;YAkCZ,iBAAiB;YAKjB,yBAAyB;WAK1B,aAAa,CACxB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IA+FlD,eAAe,CAAC,OAAO,EAAE;QAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf;IA2BD,OAAO,CAAC,YAAY;CA4KrB"}

package/dist/providers/browserstack/index.js

@@ -12,6 +12,7 @@ const types_1 = require("../../types");
 const device_1 = require("../../device");
 const logger_1 = require("../../logger");
 const s3_1 = require("./s3");
+const appiumSettings_1 = require("../appiumSettings");
 const API_BASE_URL = "https://api-cloud.browserstack.com/app-automate";
 const envVarKeyForBuild = (projectName) => `BROWSERSTACK_APP_URL_${projectName.toUpperCase()}`;
 function getAuthHeader() {
@@ -120,6 +121,19 @@ class BrowserStackDeviceProvider {
     async createDriver(config) {
         const WebDriver = (await import("webdriver")).default;
         const webDriverClient = await WebDriver.newSession(config);
+        const deviceConfig = this.project.use.device;
+        const platformName = this.project.use.platform;
+        const updateSettings = (0, appiumSettings_1.buildAppiumUpdateSettings)(deviceConfig?.appiumSettings, platformName);
+        if (updateSettings) {
+            try {
+                await webDriverClient.updateSettings(updateSettings);
+                logger_1.logger.log("Applied Appium settings via updateSettings.");
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                throw new Error(`Failed to apply appiumSettings via updateSettings: ${message}`);
+            }
+        }
         this.sessionId = webDriverClient.sessionId;
         const bundleId = await this.getAppBundleIdFromSession();
         const testOptions = {
@@ -136,6 +150,10 @@ class BrowserStackDeviceProvider {
         return this.sessionDetails?.app_details.app_name ?? "";
     }
     static async downloadVideo(sessionId, outputDir, fileName) {
+        if (process.env.APPWRIGHT_DISABLE_VIDEO_DOWNLOAD === "true") {
+            logger_1.logger.log("BrowserStack video download disabled via APPWRIGHT_DISABLE_VIDEO_DOWNLOAD.");
+            return null;
+        }
         const sessionData = await getSessionDetails(sessionId);
         const sessionDetails = sessionData?.automation_session;
         const videoURL = sessionDetails?.video_url;
@@ -293,6 +311,12 @@ class BrowserStackDeviceProvider {
         if (typeof deviceConfig?.appProfiling === "boolean") {
             bstackOptions.appProfiling = deviceConfig.appProfiling;
         }
+        if (deviceConfig?.geoLocation) {
+            bstackOptions.geoLocation = deviceConfig.geoLocation;
+        }
+        if (deviceConfig?.gpsLocation) {
+            bstackOptions.gpsLocation = deviceConfig.gpsLocation;
+        }
         // iOS App Settings support (capability-based for session start)
         if (platformName === types_1.Platform.IOS) {
             // Support environment variable override for CI/CD
@@ -323,8 +347,15 @@ class BrowserStackDeviceProvider {
             "bstack:options": bstackOptions,
             "appium:app": process.env[envVarKey],
             "appium:fullReset": true,
-            "appium:settings[snapshotMaxDepth]": 62,
         };
+        if (platformName === types_1.Platform.ANDROID) {
+            capabilities["appium:settings[snapshotMaxDepth]"] =
+                deviceConfig.appiumSettings?.snapshotMaxDepth ?? 62;
+        }
+        (0, appiumSettings_1.applyAppiumSettingsToCapabilities)(capabilities, deviceConfig.appiumSettings, platformName, {
+            includeBrowserStackSettings: true,
+            includeUpdateSettingsCapabilities: false,
+        });
         if (platformName === types_1.Platform.ANDROID) {
             const grantPreference = permissionPrompts?.android?.grantPermissions;
             if (grantPreference !== "manual") {

package/dist/providers/emulator/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/emulator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,cAAc,EAIf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAOtC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAI/C,qBAAa,gBAAiB,YAAW,cAAc;IAInD,OAAO,CAAC,OAAO;IAHjB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAGT,OAAO,EAAE,WAAW,CAAC,eAAe,CAAC,EAC7C,WAAW,EAAE,MAAM,GAAG,SAAS;IAS3B,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAI5B,WAAW;YA8BH,YAAY;YAyBZ,YAAY;CAmC3B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/emulator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,cAAc,EAIf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAQtC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAI/C,qBAAa,gBAAiB,YAAW,cAAc;IAInD,OAAO,CAAC,OAAO;IAHjB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAGT,OAAO,EAAE,WAAW,CAAC,eAAe,CAAC,EAC7C,WAAW,EAAE,MAAM,GAAG,SAAS;IAS3B,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAI5B,WAAW;YA8BH,YAAY;YAyBZ,YAAY;CAuD3B"}

package/dist/providers/emulator/index.js

@@ -4,6 +4,7 @@ exports.EmulatorProvider = void 0;
 const types_1 = require("../../types");
 const device_1 = require("../../device");
 const appium_1 = require("../appium");
+const appiumSettings_1 = require("../appiumSettings");
 const utils_1 = require("../../utils");
 const logger_1 = require("../../logger");
 class EmulatorProvider {
@@ -53,7 +54,12 @@ Follow the steps mentioned in ${androidSimulatorConfigDocLink} to run test on An
     }
     async createConfig() {
         const platformName = this.project.use.platform;
-        const udid = this.project.use.device.udid;
+        if (!this.project.use.device) {
+            throw new Error("Device configuration is required for emulator provider.");
+        }
+        const deviceConfig = this.project.use.device;
+        const udid = deviceConfig.udid;
+        const appiumSettings = deviceConfig.appiumSettings;
         let appPackageName;
         let appLaunchableActivity;
         if (platformName == types_1.Platform.ANDROID) {
@@ -61,25 +67,30 @@ Follow the steps mentioned in ${androidSimulatorConfigDocLink} to run test on An
             appPackageName = packageName;
             appLaunchableActivity = launchableActivity;
         }
+        // Build capabilities with configurable appium settings
+        const capabilities = {
+            "appium:deviceName": deviceConfig.name,
+            "appium:udid": udid,
+            "appium:automationName": platformName == types_1.Platform.ANDROID ? "uiautomator2" : "xcuitest",
+            "appium:platformVersion": deviceConfig.osVersion,
+            platformName: platformName,
+            "appium:autoGrantPermissions": true,
+            "appium:app": this.project.use.buildPath,
+            "appium:autoAcceptAlerts": true,
+            "appium:fullReset": true,
+            "appium:deviceOrientation": deviceConfig.orientation,
+            "appium:wdaLaunchTimeout": 300_000,
+        };
+        if (platformName == types_1.Platform.ANDROID) {
+            capabilities["appium:appActivity"] = appLaunchableActivity;
+            capabilities["appium:appPackage"] = appPackageName;
+            capabilities["appium:settings[snapshotMaxDepth]"] =
+                appiumSettings?.snapshotMaxDepth ?? 62;
+        }
+        (0, appiumSettings_1.applyAppiumSettingsToCapabilities)(capabilities, appiumSettings, platformName);
         return {
             port: 4723,
-            capabilities: {
-                "appium:deviceName": this.project.use.device?.name,
-                "appium:udid": udid,
-                "appium:automationName": platformName == types_1.Platform.ANDROID ? "uiautomator2" : "xcuitest",
-                "appium:platformVersion": this.project.use.device
-                    .osVersion,
-                "appium:appActivity": appLaunchableActivity,
-                "appium:appPackage": appPackageName,
-                platformName: platformName,
-                "appium:autoGrantPermissions": true,
-                "appium:app": this.project.use.buildPath,
-                "appium:autoAcceptAlerts": true,
-                "appium:fullReset": true,
-                "appium:deviceOrientation": this.project.use.device?.orientation,
-                "appium:settings[snapshotMaxDepth]": 62,
-                "appium:wdaLaunchTimeout": 300_000,
-            },
+            capabilities,
         };
     }
 }

package/dist/providers/local/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/local/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,cAAc,EAIf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAY/C,qBAAa,mBAAoB,YAAW,cAAc;IAItD,OAAO,CAAC,OAAO;IAHjB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAGT,OAAO,EAAE,WAAW,CAAC,eAAe,CAAC,EAC7C,WAAW,EAAE,MAAM,GAAG,SAAS;IAS3B,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAI5B,WAAW;YAgBH,YAAY;YA0BZ,YAAY;CA6C3B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/local/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,cAAc,EAIf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAa/C,qBAAa,mBAAoB,YAAW,cAAc;IAItD,OAAO,CAAC,OAAO;IAHjB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAGT,OAAO,EAAE,WAAW,CAAC,eAAe,CAAC,EAC7C,WAAW,EAAE,MAAM,GAAG,SAAS;IAS3B,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAI5B,WAAW;YAgBH,YAAY;YA0BZ,YAAY;CAkE3B"}

package/dist/providers/local/index.js

@@ -4,6 +4,7 @@ exports.LocalDeviceProvider = void 0;
 const types_1 = require("../../types");
 const device_1 = require("../../device");
 const appium_1 = require("../appium");
+const appiumSettings_1 = require("../appiumSettings");
 const utils_1 = require("../../utils");
 const logger_1 = require("../../logger");
 class LocalDeviceProvider {
@@ -44,6 +45,11 @@ class LocalDeviceProvider {
     }
     async createConfig() {
         const platformName = this.project.use.platform;
+        if (!this.project.use.device) {
+            throw new Error("Device configuration is required for local device provider.");
+        }
+        const deviceConfig = this.project.use.device;
+        const appiumSettings = deviceConfig.appiumSettings;
         let appPackageName;
         let appLaunchableActivity;
         if (platformName == types_1.Platform.ANDROID) {
@@ -51,7 +57,7 @@ class LocalDeviceProvider {
             appPackageName = packageName;
             appLaunchableActivity = launchableActivity;
         }
-        let udid = this.project.use.device.udid;
+        let udid = deviceConfig.udid;
         if (!udid) {
             if (platformName == types_1.Platform.IOS) {
                 udid = await (0, appium_1.getConnectedIOSDeviceUDID)();
@@ -59,27 +65,33 @@ class LocalDeviceProvider {
             else {
                 const activeAndroidDevices = await (0, appium_1.getActiveAndroidDevices)();
                 if (activeAndroidDevices > 1) {
-                    logger_1.logger.warn(`Multiple active devices detected. Selecting one for the test. 
+                    logger_1.logger.warn(`Multiple active devices detected. Selecting one for the test.
 To specify a device, use the udid property. Run "adb devices" to get the UDID for active devices.`);
                 }
             }
         }
+        // Build capabilities with configurable appium settings
+        const capabilities = {
+            "appium:deviceName": deviceConfig.name,
+            "appium:udid": udid,
+            "appium:automationName": platformName == types_1.Platform.ANDROID ? "uiautomator2" : "xcuitest",
+            platformName: platformName,
+            "appium:autoGrantPermissions": true,
+            "appium:app": this.project.use.buildPath,
+            "appium:autoAcceptAlerts": true,
+            "appium:fullReset": true,
+            "appium:deviceOrientation": deviceConfig.orientation,
+        };
+        if (platformName == types_1.Platform.ANDROID) {
+            capabilities["appium:appActivity"] = appLaunchableActivity;
+            capabilities["appium:appPackage"] = appPackageName;
+            capabilities["appium:settings[snapshotMaxDepth]"] =
+                appiumSettings?.snapshotMaxDepth ?? 62;
+        }
+        (0, appiumSettings_1.applyAppiumSettingsToCapabilities)(capabilities, appiumSettings, platformName);
         return {
             port: 4723,
-            capabilities: {
-                "appium:deviceName": this.project.use.device?.name,
-                "appium:udid": udid,
-                "appium:automationName": platformName == types_1.Platform.ANDROID ? "uiautomator2" : "xcuitest",
-                platformName: platformName,
-                "appium:autoGrantPermissions": true,
-                "appium:app": this.project.use.buildPath,
-                "appium:appActivity": appLaunchableActivity,
-                "appium:appPackage": appPackageName,
-                "appium:autoAcceptAlerts": true,
-                "appium:fullReset": true,
-                "appium:deviceOrientation": this.project.use.device?.orientation,
-                "appium:settings[snapshotMaxDepth]": 62,
-            },
+            capabilities,
         };
     }
 }

package/dist/reporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAUhF,cAAM,eAAgB,YAAW,QAAQ;IACvC,OAAO,CAAC,gBAAgB,CAAsB;IAE9C,OAAO;IAQP,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU;IAU9C,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU;IA2FtC,KAAK;YAKG,kCAAkC;IA6ChD,OAAO,CAAC,4BAA4B;IAyBpC,OAAO,CAAC,qBAAqB;CAI9B;AA8ED,eAAe,eAAe,CAAC"}
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAUhF,cAAM,eAAgB,YAAW,QAAQ;IACvC,OAAO,CAAC,gBAAgB,CAAsB;IAE9C,OAAO;IAQP,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU;IAU9C,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU;IAsGtC,KAAK;YAKG,kCAAkC;IA6ChD,OAAO,CAAC,4BAA4B;IAyBpC,OAAO,CAAC,qBAAqB;CAU9B;AA8ED,eAAe,eAAe,CAAC"}

package/dist/reporter.js

@@ -35,8 +35,10 @@ class VideoDownloader {
             // This is a test that ran with the `device` fixture
             const sessionId = sessionIdAnnotation.description;
             const providerName = providerNameAnnotation.description;
-            const provider = (0, providers_1.getProviderClass)(providerName);
-            this.downloadAndAttachDeviceVideo(test, result, provider, sessionId);
+            if (this.providerSupportsVideo(providerName)) {
+                const provider = (0, providers_1.getProviderClass)(providerName);
+                this.downloadAndAttachDeviceVideo(test, result, provider, sessionId);
+            }
             const otherAnnotations = test.annotations.filter(({ type }) => type !== "sessionId" && type !== "providerName");
             test.annotations = otherAnnotations;
         }
@@ -54,36 +56,43 @@ class VideoDownloader {
             // The `onTestEnd` is method is called before the worker ends and
             // the worker's `endTime` is saved to disk. We add a 5 secs delay
             // to prevent a harmful race condition.
-            const workerDownload = waitFiveSeconds()
-                .then(() => getWorkerInfo(workerIndex))
-                .then(async (workerInfo) => {
-                if (!workerInfo) {
-                    throw new Error(`Worker info not found for idx: ${workerIndex}`);
-                }
-                const { providerName, sessionId, endTime } = workerInfo;
-                if (!providerName || !sessionId) {
-                    throw new Error(`Provider name or session id not found for worker: ${workerIndex}`);
-                }
-                if (!this.providerSupportsVideo(providerName)) {
-                    return; // Nothing to do here
+            const workerDownload = getWorkerInfo(workerIndex)
+                .then((initialWorkerInfo) => {
+                const providerName = initialWorkerInfo?.providerName;
+                if (providerName && !this.providerSupportsVideo(providerName)) {
+                    return;
                 }
-                const workerVideoBaseName = `worker-${workerIndex}-${sessionId}-video`;
-                if (endTime) {
-                    // This is the last test in the worker, so let's download the video
-                    const provider = (0, providers_1.getProviderClass)(providerName);
-                    const downloaded = await provider.downloadVideo(sessionId, (0, utils_1.basePath)(), workerVideoBaseName);
-                    if (!downloaded) {
-                        return;
+                return waitFiveSeconds()
+                    .then(() => getWorkerInfo(workerIndex))
+                    .then(async (workerInfo) => {
+                    if (!workerInfo) {
+                        throw new Error(`Worker info not found for idx: ${workerIndex}`);
                     }
-                    return this.trimAndAttachPersistentDeviceVideo(test, result, downloaded.path);
-                }
-                else {
-                    // This is an intermediate test in the worker, so let's wait for the
-                    // video file to be found on disk. Once it is, we trim and attach it.
-                    const expectedWorkerVideoPath = path_1.default.join((0, utils_1.basePath)(), `${workerVideoBaseName}.mp4`);
-                    await waitFor(() => fs_1.default.existsSync(expectedWorkerVideoPath));
-                    return this.trimAndAttachPersistentDeviceVideo(test, result, expectedWorkerVideoPath);
-                }
+                    const { providerName, sessionId, endTime } = workerInfo;
+                    if (!providerName || !sessionId) {
+                        throw new Error(`Provider name or session id not found for worker: ${workerIndex}`);
+                    }
+                    if (!this.providerSupportsVideo(providerName)) {
+                        return; // Nothing to do here
+                    }
+                    const workerVideoBaseName = `worker-${workerIndex}-${sessionId}-video`;
+                    if (endTime) {
+                        // This is the last test in the worker, so let's download the video
+                        const provider = (0, providers_1.getProviderClass)(providerName);
+                        const downloaded = await provider.downloadVideo(sessionId, (0, utils_1.basePath)(), workerVideoBaseName);
+                        if (!downloaded) {
+                            return;
+                        }
+                        return this.trimAndAttachPersistentDeviceVideo(test, result, downloaded.path);
+                    }
+                    else {
+                        // This is an intermediate test in the worker, so let's wait for the
+                        // video file to be found on disk. Once it is, we trim and attach it.
+                        const expectedWorkerVideoPath = path_1.default.join((0, utils_1.basePath)(), `${workerVideoBaseName}.mp4`);
+                        await waitFor(() => fs_1.default.existsSync(expectedWorkerVideoPath));
+                        return this.trimAndAttachPersistentDeviceVideo(test, result, expectedWorkerVideoPath);
+                    }
+                });
             })
                 .catch((e) => {
                 logger_1.logger.error("Failed to get worker end time:", e);
@@ -156,6 +165,10 @@ class VideoDownloader {
         this.downloadPromises.push(downloadPromise);
     }
     providerSupportsVideo(providerName) {
+        if (providerName === "browserstack" &&
+            process.env.APPWRIGHT_DISABLE_VIDEO_DOWNLOAD === "true") {
+            return false;
+        }
         const provider = (0, providers_1.getProviderClass)(providerName);
         return !!provider.downloadVideo;
     }

package/dist/tests/reporter.spec.js

@@ -73,6 +73,7 @@ let VideoDownloader;
     mockBasePath = "";
     getProviderClassMock.mockClear();
     vitest_1.vi.useRealTimers();
+    delete process.env.APPWRIGHT_DISABLE_VIDEO_DOWNLOAD;
     if (basePathToDelete) {
         await promises_1.default.rm(basePathToDelete, { recursive: true, force: true });
     }
@@ -164,4 +165,40 @@ let VideoDownloader;
             },
         ]);
     });
+    (0, vitest_1.test)("skips BrowserStack video handling when video download is disabled", async () => {
+        vitest_1.vi.useFakeTimers();
+        process.env.APPWRIGHT_DISABLE_VIDEO_DOWNLOAD = "true";
+        mockBasePath = await promises_1.default.mkdtemp(path_1.default.join(os_1.default.tmpdir(), "appwright-videos-"));
+        const workerIndex = 0;
+        const sessionId = "session-xyz";
+        const providerName = "browserstack";
+        const workerStart = new Date("2025-01-01T00:00:00.000Z");
+        await promises_1.default.writeFile(path_1.default.join(mockBasePath, `worker-info-${workerIndex}.json`), JSON.stringify({
+            idx: workerIndex,
+            sessionId,
+            providerName,
+            startTime: {
+                beforeAppiumSession: workerStart.toISOString(),
+                afterAppiumSession: workerStart.toISOString(),
+            },
+            tests: [],
+        }, null, 2));
+        const reporter = new VideoDownloader();
+        const testCase = {
+            id: "test-1",
+            title: "persistent",
+            annotations: [],
+        };
+        const testResult = {
+            workerIndex,
+            duration: 1,
+            startTime: new Date("2025-01-01T00:00:10.000Z"),
+            attachments: [],
+        };
+        reporter.onTestEnd(testCase, testResult);
+        await vitest_1.vi.advanceTimersByTimeAsync(5000);
+        await reporter.onEnd();
+        (0, vitest_1.expect)(downloadVideoMock).not.toHaveBeenCalled();
+        (0, vitest_1.expect)(testResult.attachments).toEqual([]);
+    });
 });

package/dist/types/index.d.ts

@@ -100,6 +100,14 @@ export type BrowserStackConfig = {
      * Defaults to Appium 3.1.0. Override if your account requires a different version.
      */
     appiumVersion?: string;
+    /**
+     * BrowserStack geolocation code (for example: "HK").
+     */
+    geoLocation?: string;
+    /**
+     * BrowserStack GPS location coordinates ("lat,long").
+     */
+    gpsLocation?: string;
     /**
      * Enable BrowserStack App Performance profiling (appProfiling capability).
      * Defaults to false. When true, BrowserStack captures detailed performance metrics.
@@ -111,6 +119,11 @@ export type BrowserStackConfig = {
      * Defaults to 180 seconds (3 minutes).
      */
     idleTimeout?: number;
+    /**
+     * Appium settings applied after session start via driver.updateSettings.
+     * Use to tune selector/idle behavior for flaky runs.
+     */
+    appiumSettings?: AppiumSettings;
     /**
      * iOS app settings to configure at session start.
      * Can include Permission Settings and/or custom Settings Bundle entries.
@@ -251,6 +264,103 @@ export type AWSDeviceFarmConfig = {
      */
     externalId?: string;
 };
+/**
+ * Appium settings for controlling UIAutomator2/XCUITest behavior.
+ * These settings affect how Appium interacts with the device during automation.
+ */
+export type AppiumSettings = {
+    /**
+     * Maximum time (in milliseconds) that UIAutomator2 will wait for the UI to become idle
+     * before performing actions. Lower values speed up tests on apps with animations
+     * or dynamic content that never become truly "idle".
+     * Default: 10000 (10 seconds). Recommended for animated apps: 0-2000.
+     * Only applies to Android.
+     */
+    waitForIdleTimeout?: number;
+    /**
+     * Maximum time (in seconds) between Appium commands before the session times out.
+     * Useful for long-running tests or tests that include extended wait periods.
+     * Default: 60 seconds.
+     */
+    newCommandTimeout?: number;
+    /**
+     * Maximum depth of the element tree snapshot. Higher values capture more nested elements
+     * but may slow down element lookups on complex screens.
+     * Default: 50. Max recommended: 62.
+     * Only applies to Android.
+     */
+    snapshotMaxDepth?: number;
+    /**
+     * Maximum time (in milliseconds) to wait for an element to appear.
+     * Only applies to Android.
+     */
+    waitForSelectorTimeout?: number;
+    /**
+     * Timeout (in milliseconds) for UIAutomator2 action acknowledgments.
+     * Only applies to Android.
+     */
+    actionAcknowledgmentTimeout?: number;
+    /**
+     * Whether to ignore non-important views in the Android view hierarchy.
+     * Only applies to Android.
+     */
+    ignoreUnimportantViews?: boolean;
+    /**
+     * Snapshot timeout (in milliseconds) for Android UIAutomator2.
+     * Only applies to Android.
+     */
+    customSnapshotTimeout?: number;
+    /**
+     * Snapshot timeout (in milliseconds) for iOS XCUITest.
+     * Only applies to iOS.
+     */
+    snapshotTimeout?: number;
+    /**
+     * Whether to wait for app quiescence on iOS.
+     * Only applies to iOS.
+     */
+    waitForQuiescence?: boolean;
+    /**
+     * Cool-off timeout (in milliseconds) for animations on iOS.
+     * Only applies to iOS.
+     */
+    animationCoolOffTimeout?: number;
+    /**
+     * Reduce motion on iOS during automation.
+     * Only applies to iOS.
+     */
+    reduceMotion?: boolean;
+    /**
+     * Disable window animations on Android.
+     * Only applies to Android.
+     */
+    disableWindowAnimation?: boolean;
+    /**
+     * Skip device initialization to speed up Android sessions.
+     * Only applies to Android.
+     */
+    skipDeviceInitialization?: boolean;
+    /**
+     * Include Safari in webviews for iOS.
+     * Only applies to iOS.
+     */
+    includeSafariInWebviews?: boolean;
+    /**
+     * Allow Appium to auto-download Chromedriver binaries.
+     * Only applies to Android.
+     */
+    chromedriverAutodownload?: boolean;
+    /**
+     * BrowserStack page source sampling configuration.
+     * Only applies to BrowserStack.
+     */
+    bstackPageSource?: {
+        enable?: boolean;
+        samplesX?: number;
+        samplesY?: number;
+        maxDepth?: number;
+    };
+} & Record<string, unknown>;
 /**
  * Configuration for locally connected physical devices.
  */
@@ -266,6 +376,10 @@ export type LocalDeviceConfig = {
      * Default orientation is "portrait".
      */
     orientation?: DeviceOrientation;
+    /**
+     * Appium settings for controlling UIAutomator2/XCUITest behavior.
+     */
+    appiumSettings?: AppiumSettings;
 };
 /**
  * Configuration for running tests on an Android or iOS emulator.
@@ -283,6 +397,10 @@ export type EmulatorConfig = {
      * Default orientation is "portrait".
      */
     orientation?: DeviceOrientation;
+    /**
+     * Appium settings for controlling UIAutomator2/XCUITest behavior.
+     */
+    appiumSettings?: AppiumSettings;
 };
 /**
  * iOS permission settings structure (based on BrowserStack API).

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,KAAK,EAAE,sCAAsC,EAAE,MAAM,6BAA6B,CAAC;AAC1F,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;AAEtE,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B;;OAEG;IACH,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAE7B;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrB;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IAEpB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,KAAK,GAAG,mBAAmB,CAAC;IAEjE;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,YAAY,GACpB,kBAAkB,GAClB,gBAAgB,GAChB,iBAAiB,GACjB,cAAc,GACd,mBAAmB,CAAC;AAExB;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,cAAc,CAAC;IAEzB;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAEhC;;;OAGG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IAErC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;;;;;;;;;;;;OAcG;IACH,iBAAiB,CAAC,EAAE,cAAc,CAAC;IAEnC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,6BAA6B,CAAC;CACnD,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,OAAO,CAAC,EAAE;QACR;;WAEG;QACH,gBAAgB,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;KACvC,CAAC;IACF,GAAG,CAAC,EAAE;QACJ;;WAEG;QACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;KAC5C,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,YAAY,CAAC;IAEvB;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAEhC;;;OAGG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IAErC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GACpC,aAAa,GACb,UAAU,GACV,YAAY,CAAC;AAEjB,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,eAAe,CAAC,EAAE,4BAA4B,CAAC;IAC/C;;OAEG;IACH,aAAa,CAAC,EAAE,sCAAsC,CAAC;IACvD;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAEhC;;;OAGG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAAC;IAErC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;OAGG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAEjC;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;;OAGG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAEnC;;;OAGG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC;;;OAGG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAEnC;;;OAGG;IACH,gBAAgB,CAAC,EAAE;QACjB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5B;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,cAAc,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAEhC;;OAEG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,UAAU,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAEhC;;OAEG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAAC;IAC1C,QAAQ,EAAE,OAAO,CAAC;QAChB,uBAAuB,EAAE,QAAQ,GAAG,qBAAqB,GAAG,OAAO,CAAC;QACpE,kBAAkB,EAAE,IAAI,GAAG,KAAK,CAAC;KAClC,CAAC,CAAC;IACH,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;IAC3B,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,GAAG,YAAY,GAAG,MAAM,CAAC;IACtE,aAAa,EAAE,OAAO,CAAC;QACrB,qBAAqB,EAAE,IAAI,GAAG,KAAK,CAAC;KACrC,CAAC,CAAC;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAExD;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,qBAAqB,EAAE,qBAAqB,CAAA;CAAE,GAChD,iBAAiB,GACjB,CAAC;IAAE,qBAAqB,EAAE,qBAAqB,CAAA;CAAE,GAAG,iBAAiB,CAAC,CAAC;AAE3E,oBAAY,QAAQ;IAClB,OAAO,YAAY;IACnB,GAAG,QAAQ;CACZ;AAED,oBAAY,iBAAiB;IAC3B,QAAQ,aAAa;IACrB,SAAS,cAAc;CACxB;AAED,oBAAY,eAAe;IACzB,EAAE,OAAO;IACT,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;OASG;IACH,GAAG,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C;;;;;;;;;;OAUG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5D;;;;;;;;;;OAUG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtE;;;;;;;;;;;OAWG;IACH,OAAO,CACL,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;;;;;OAUG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErD;;;;;;;;;OASG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAElD,MAAM,CAAC,SAAS,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD;AAED,oBAAY,eAAe;IACzB,0BAA0B,4BAA4B;CACvD;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;AAClE,MAAM,MAAM,kBAAkB,GAAG,qCAAqC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@samsara-dev/appwright",
-  "version": "0.9.5",
+  "version": "0.9.7",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
@@ -50,7 +50,8 @@
     "form-data": "4.0.5",
     "node-fetch": "^3.3.2",
     "picocolors": "^1.1.0",
-    "webdriver": "^8.36.1"
+    "webdriver": "^8.36.1",
+    "gpt-driver-node": "^1.0.4"
   },
   "devDependencies": {
     "@changesets/cli": "^2.29.8",