@probolabs/playwright 1.0.12 → 1.0.15

package/README.md

@@ -1,227 +1,227 @@
-# Probolib: drive your playwright scripts with AI superpowers
-
-Probolib is a powerful AI-driven automation library that enhances Playwright testing and automation by making your scripts more robust and maintainable. Instead of relying on brittle CSS selectors or complex XPath expressions, Probolib uses natural language to interact with web elements.
-
-## Why Probolib?
-
-- **Natural Language Automation**: Write human-readable instructions instead of complex selectors
-- **More Resilient Tests**: AI-powered element detection that adapts to UI changes
-- **Simpler Maintenance**: Reduce the need to update selectors when the UI changes
-- **Faster Development**: Write automation scripts in plain English
-
-## Example
-
-Instead of writing:
-
-```
-page.click('some > super > complex > css > and non robust selector')
-```
-
-You can simply write:
-
-```
-probo.runStep(page, 'click on the save button')
-```
-
-## Quickstart
-
-```
-npm install @probolabs/playwright
-```
-
-## Accessing our backend
-
-the heavy lifting of the AI reasoning is done at the moment on our backend server. in order to access it you would need to tell the library how to access it.
-
-## easyiest - set ENV var
-
-probolib expects the existance of 2 env vars:
-
-```
-export PROBO_API_ENDPOINT=api.probolabs.ai
-export PROBO_API_KEY=<api key we will give you>
-
-```
-
-Or use dotenv
-
-```
-// npm install dotenv
-// in your script add this line
-import 'dotenv/config' // ES6
-
-// .env file located in the root of your project (the same level as your package.json)
-PROBO_API_ENDPOINT=https://api.probolabs.ai
-PROBO_API_KEY=<api key we will give you>
-
-```
-
-## A complete example for Playwright integration. step by step
-
-**step 1:** init a playwright project
-
-```
-# from your work directory
-mkdir probo-example
-cd probo-example
-npm init playwright@latest
-# follow the instructions and wait till the installation is finished
-# verify that playwright is installed properly
-npx playwright test --project chromium
-```
-
-**step 2**: integrate probolabs
-
-```
-npm install @probolabs/playwright dotenv
-```
-
-**step 3:** configure the env with our endpoint and api key
-
-```
-touch .env
-```
-
-edit the .env file
-
-```
-#.env
-PROBO_API_ENDPOINT=https://api.probolabs.ai
-PROBO_API_KEY=<api key we will give you>
-
-```
-
-**step 4:** create a file under the tests folder named `probo-example-todo-mvc.spec.mjs`
-
-```
-// tests/probo-example-todo-mvc.spec.mjs
-import 'dotenv/config';
-import { test} from '@playwright/test';
-import { Probo } from '@probolabs/playwright';
-
-//
-// Important: Before running this script set PROBO_API_KEY and PROBO_API_ENDPOINT
-//
-
-test.describe('Todo MVC', () => {
-  test('basic example', async ({ page }) => {
-    try {
-      // Initialize Probo
-      const probo = new Probo({
-        scenarioName: 'probo-example-todo-mvc' // important for caching the AI reasoning
-      });
-
-      //Goto page
-      await page.goto('https://demo.playwright.dev/todomvc');
-
-      // Run test steps
-      console.log('Running test steps...');
-      await probo.runStep(page, 'enter a new todo item: "Buy groceries"');
-      await probo.runStep(page, 'press the Enter key');
-
-      console.log('✨ Test completed successfully!');
-    } catch (error) {
-      console.error('❌ Test failed:', error);
-      throw error; // Re-throw to mark the test as failed
-    }
-  });
-});
-
-```
-
-**run the example**
-
-```
-npx playwright test tests/probo-example-todo-mvc.spec.mjs --headed --project chromium
-```
-
-## Using Probo Fixtures (Connect to Existing Browser)
-
-Probo fixtures allow you to connect to an existing Chrome instance (like your recorder app) instead of launching a new browser. This is useful when you want to run tests against a browser that's already running with specific extensions or configurations.
-
-### Quick Setup
-
-**Step 1:** Install the package
-
-```bash
-npm install @probolabs/playwright
-```
-
-**Step 2:** Create a `playwright.config.ts` file
-
-```typescript
-// playwright.config.ts
-import { defineConfig } from "@playwright/test";
-
-export default defineConfig({
-  testDir: "./tests",
-  use: {
-    // Don't launch a new browser - Probo fixtures will connect to existing one
-    launchOptions: {},
-  },
-  workers: 1, // Use 1 worker to avoid conflicts with existing browser
-});
-```
-
-**Step 3:** Use Probo fixtures in your test files
-
-```typescript
-// tests/example.spec.ts
-import { test, expect } from "@probolabs/playwright/fixtures";
-
-test.describe("My Tests", () => {
-  test("should work with existing browser", async ({ page }) => {
-    // This page comes from your existing Chrome instance
-    await page.goto("https://example.com");
-    await page.click("button");
-
-    // Your test code here...
-  });
-});
-```
-
-**Step 4:** Make sure your recorder app is running, then run tests
-
-```bash
-npx playwright test
-```
-
-### Advanced Configuration
-
-You can customize the fixtures with different options:
-
-```typescript
-// tests/example.spec.ts
-import { createProboFixtures, expect } from "@probolabs/playwright/fixtures";
-
-// Create custom fixtures with specific configuration
-const test = createProboFixtures({
-  debugPort: 9333, // Default port where your recorder app runs
-  showBrowserConsole: true, // Show browser console logs
-});
-
-test.describe("My Tests", () => {
-  test("custom configuration", async ({ page }) => {
-    // Your test code here...
-  });
-});
-```
-
-### Requirements
-
-- Your recorder app must be running with Chrome accessible via CDP
-- Chrome must be launched with `--remote-debugging-port=9333` (or your custom port)
-- The browser must have at least one page open (not just extension pages)
-
-### Troubleshooting
-
-**Error: "No browser context found"**
-
-- Make sure your recorder app is running
-- Check that Chrome is accessible at `http://localhost:9333`
-- Verify the debug port matches your configuration
-
-**Error: "No main page found"**
-
-- Make sure your recorder app has opened a page
-- The page should not be a chrome-extension:// URL
+# Probolib: drive your playwright scripts with AI superpowers
+
+Probolib is a powerful AI-driven automation library that enhances Playwright testing and automation by making your scripts more robust and maintainable. Instead of relying on brittle CSS selectors or complex XPath expressions, Probolib uses natural language to interact with web elements.
+
+## Why Probolib?
+
+- **Natural Language Automation**: Write human-readable instructions instead of complex selectors
+- **More Resilient Tests**: AI-powered element detection that adapts to UI changes
+- **Simpler Maintenance**: Reduce the need to update selectors when the UI changes
+- **Faster Development**: Write automation scripts in plain English
+
+## Example
+
+Instead of writing:
+
+```
+page.click('some > super > complex > css > and non robust selector')
+```
+
+You can simply write:
+
+```
+probo.runStep(page, 'click on the save button')
+```
+
+## Quickstart
+
+```
+npm install @probolabs/playwright
+```
+
+## Accessing our backend
+
+the heavy lifting of the AI reasoning is done at the moment on our backend server. in order to access it you would need to tell the library how to access it.
+
+## easyiest - set ENV var
+
+probolib expects the existance of 2 env vars:
+
+```
+export PROBO_API_ENDPOINT=api.probolabs.ai
+export PROBO_API_KEY=<api key we will give you>
+
+```
+
+Or use dotenv
+
+```
+// npm install dotenv
+// in your script add this line
+import 'dotenv/config' // ES6
+
+// .env file located in the root of your project (the same level as your package.json)
+PROBO_API_ENDPOINT=https://api.probolabs.ai
+PROBO_API_KEY=<api key we will give you>
+
+```
+
+## A complete example for Playwright integration. step by step
+
+**step 1:** init a playwright project
+
+```
+# from your work directory
+mkdir probo-example
+cd probo-example
+npm init playwright@latest
+# follow the instructions and wait till the installation is finished
+# verify that playwright is installed properly
+npx playwright test --project chromium
+```
+
+**step 2**: integrate probolabs
+
+```
+npm install @probolabs/playwright dotenv
+```
+
+**step 3:** configure the env with our endpoint and api key
+
+```
+touch .env
+```
+
+edit the .env file
+
+```
+#.env
+PROBO_API_ENDPOINT=https://api.probolabs.ai
+PROBO_API_KEY=<api key we will give you>
+
+```
+
+**step 4:** create a file under the tests folder named `probo-example-todo-mvc.spec.mjs`
+
+```
+// tests/probo-example-todo-mvc.spec.mjs
+import 'dotenv/config';
+import { test} from '@playwright/test';
+import { Probo } from '@probolabs/playwright';
+
+//
+// Important: Before running this script set PROBO_API_KEY and PROBO_API_ENDPOINT
+//
+
+test.describe('Todo MVC', () => {
+  test('basic example', async ({ page }) => {
+    try {
+      // Initialize Probo
+      const probo = new Probo({
+        scenarioName: 'probo-example-todo-mvc' // important for caching the AI reasoning
+      });
+
+      //Goto page
+      await page.goto('https://demo.playwright.dev/todomvc');
+
+      // Run test steps
+      console.log('Running test steps...');
+      await probo.runStep(page, 'enter a new todo item: "Buy groceries"');
+      await probo.runStep(page, 'press the Enter key');
+
+      console.log('✨ Test completed successfully!');
+    } catch (error) {
+      console.error('❌ Test failed:', error);
+      throw error; // Re-throw to mark the test as failed
+    }
+  });
+});
+
+```
+
+**run the example**
+
+```
+npx playwright test tests/probo-example-todo-mvc.spec.mjs --headed --project chromium
+```
+
+## Using Probo Fixtures (Connect to Existing Browser)
+
+Probo fixtures allow you to connect to an existing Chrome instance (like your recorder app) instead of launching a new browser. This is useful when you want to run tests against a browser that's already running with specific extensions or configurations.
+
+### Quick Setup
+
+**Step 1:** Install the package
+
+```bash
+npm install @probolabs/playwright
+```
+
+**Step 2:** Create a `playwright.config.ts` file
+
+```typescript
+// playwright.config.ts
+import { defineConfig } from "@playwright/test";
+
+export default defineConfig({
+  testDir: "./tests",
+  use: {
+    // Don't launch a new browser - Probo fixtures will connect to existing one
+    launchOptions: {},
+  },
+  workers: 1, // Use 1 worker to avoid conflicts with existing browser
+});
+```
+
+**Step 3:** Use Probo fixtures in your test files
+
+```typescript
+// tests/example.spec.ts
+import { test, expect } from "@probolabs/playwright/fixtures";
+
+test.describe("My Tests", () => {
+  test("should work with existing browser", async ({ page }) => {
+    // This page comes from your existing Chrome instance
+    await page.goto("https://example.com");
+    await page.click("button");
+
+    // Your test code here...
+  });
+});
+```
+
+**Step 4:** Make sure your recorder app is running, then run tests
+
+```bash
+npx playwright test
+```
+
+### Advanced Configuration
+
+You can customize the fixtures with different options:
+
+```typescript
+// tests/example.spec.ts
+import { createProboFixtures, expect } from "@probolabs/playwright/fixtures";
+
+// Create custom fixtures with specific configuration
+const test = createProboFixtures({
+  debugPort: 9333, // Default port where your recorder app runs
+  showBrowserConsole: true, // Show browser console logs
+});
+
+test.describe("My Tests", () => {
+  test("custom configuration", async ({ page }) => {
+    // Your test code here...
+  });
+});
+```
+
+### Requirements
+
+- Your recorder app must be running with Chrome accessible via CDP
+- Chrome must be launched with `--remote-debugging-port=9333` (or your custom port)
+- The browser must have at least one page open (not just extension pages)
+
+### Troubleshooting
+
+**Error: "No browser context found"**
+
+- Make sure your recorder app is running
+- Check that Chrome is accessible at `http://localhost:9333`
+- Verify the debug port matches your configuration
+
+**Error: "No main page found"**
+
+- Make sure your recorder app has opened a page
+- The page should not be a chrome-extension:// URL

package/dist/fixtures.js.map

@@ -1 +1 @@
-{"version":3,"file":"fixtures.js","sources":["../src/fixtures.ts"],"sourcesContent":["import { test as base, chromium } from '@playwright/test';\r\nimport { readFileSync, mkdtempSync } from 'fs';\r\nimport { join, dirname } from 'path';\r\nimport { tmpdir } from 'os';\r\nimport AdmZip from 'adm-zip';\r\nimport { fileURLToPath } from 'url';\r\n\r\nconst __filename = fileURLToPath(import.meta.url);\r\nconst __dirname = dirname(__filename);\r\n\r\n/**\r\n * Configuration options for Probo fixtures\r\n */\r\nexport interface ProboFixturesConfig {\r\n  /** Whether to show browser console logs */\r\n  showBrowserConsole?: boolean;\r\n  /** Custom path to extensions directory */\r\n  extensionsPath?: string;\r\n}\r\n\r\n/**\r\n * Extracts a CRX file to a temporary directory\r\n * Uses adm-zip with manual ZIP content detection\r\n */\r\nfunction extractCrxFile(crxPath: string): string {\r\n  const crxBuffer = readFileSync(crxPath);\r\n  \r\n  // Find ZIP content by looking for ZIP magic number (PK)\r\n  let zipStart = -1;\r\n  for (let i = 0; i < crxBuffer.length - 4; i++) {\r\n    if (crxBuffer[i] === 0x50 && crxBuffer[i + 1] === 0x4B) { // \"PK\"\r\n      zipStart = i;\r\n      break;\r\n    }\r\n  }\r\n  \r\n  if (zipStart === -1) {\r\n    throw new Error('Could not find ZIP content in CRX file');\r\n  }\r\n  \r\n  const zipBuffer = crxBuffer.subarray(zipStart);\r\n  \r\n  // Create temporary directory\r\n  const tempDir = mkdtempSync(join(tmpdir(), 'probo-extension-'));\r\n  \r\n  // Extract ZIP content\r\n  const zip = new AdmZip(zipBuffer);\r\n  zip.extractAllTo(tempDir, true);\r\n  \r\n  return tempDir;\r\n}\r\n\r\n/**\r\n * Creates Probo fixtures that launch Chromium with extensions\r\n * \r\n * @param config Configuration options for the fixtures\r\n * @returns Extended test function with Probo fixtures\r\n */\r\nexport function createProboFixtures(config: ProboFixturesConfig = {}) {\r\n  const { showBrowserConsole = false, extensionsPath } = config;\r\n  \r\n  // Default extensions path\r\n  const defaultExtensionsPath = join(__dirname, '../loaded_extensions');\r\n  const extensionsDir = extensionsPath || defaultExtensionsPath;\r\n\r\n  return base.extend({\r\n    context: async ({headless}, use) => {\r\n      // Extract extensions\r\n      const extensionDirs: string[] = [];\r\n      \r\n      try {\r\n        const crxFile = join(extensionsDir, 'microsoft-single-sign-on.crx');\r\n        const extractedDir = extractCrxFile(crxFile);\r\n        extensionDirs.push(extractedDir);\r\n      } catch (error) {\r\n        console.warn('Could not load Microsoft SSO extension:', error);\r\n      }\r\n      \r\n      // Launch Chromium with extensions\r\n      const userDataDir = mkdtempSync(join(tmpdir(), 'probo-user-data-'));\r\n      \r\n      const context = await chromium.launchPersistentContext(userDataDir, {\r\n        headless, // Extensions work better in non-headless mode\r\n        args: [\r\n          ...extensionDirs.map(dir => `--load-extension=${dir}`),\r\n          '--disable-extensions-except=' + extensionDirs.join(','),\r\n          '--disable-web-security', // Allow extensions to work properly\r\n          '--disable-features=VizDisplayCompositor'\r\n        ]\r\n      });\r\n      \r\n      await use(context);\r\n      \r\n      // Cleanup\r\n      await context.close();\r\n    },\r\n    \r\n    page: async ({ context }, use) => {\r\n      const page = await context.newPage();\r\n      \r\n      // Set up console logging if requested\r\n      if (showBrowserConsole) {\r\n        page.on('console', msg => console.log('Browser console:', msg.text()));\r\n      }\r\n      \r\n      await use(page);\r\n      await page.close();\r\n    },\r\n  });\r\n}\r\n\r\n/**\r\n * Default Probo fixtures with standard configuration\r\n * Launches Chromium with Microsoft SSO extension\r\n */\r\nexport const test = createProboFixtures();\r\n\r\n/**\r\n * Re-export expect from Playwright for convenience\r\n */\r\nexport { expect } from '@playwright/test';\r\n"],"names":["base"],"mappings":"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"}
+{"version":3,"file":"fixtures.js","sources":["../src/fixtures.ts"],"sourcesContent":["import { test as base, chromium } from '@playwright/test';\nimport { readFileSync, mkdtempSync } from 'fs';\nimport { join, dirname } from 'path';\nimport { tmpdir } from 'os';\nimport AdmZip from 'adm-zip';\nimport { fileURLToPath } from 'url';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\n/**\n * Configuration options for Probo fixtures\n */\nexport interface ProboFixturesConfig {\n  /** Whether to show browser console logs */\n  showBrowserConsole?: boolean;\n  /** Custom path to extensions directory */\n  extensionsPath?: string;\n}\n\n/**\n * Extracts a CRX file to a temporary directory\n * Uses adm-zip with manual ZIP content detection\n */\nfunction extractCrxFile(crxPath: string): string {\n  const crxBuffer = readFileSync(crxPath);\n  \n  // Find ZIP content by looking for ZIP magic number (PK)\n  let zipStart = -1;\n  for (let i = 0; i < crxBuffer.length - 4; i++) {\n    if (crxBuffer[i] === 0x50 && crxBuffer[i + 1] === 0x4B) { // \"PK\"\n      zipStart = i;\n      break;\n    }\n  }\n  \n  if (zipStart === -1) {\n    throw new Error('Could not find ZIP content in CRX file');\n  }\n  \n  const zipBuffer = crxBuffer.subarray(zipStart);\n  \n  // Create temporary directory\n  const tempDir = mkdtempSync(join(tmpdir(), 'probo-extension-'));\n  \n  // Extract ZIP content\n  const zip = new AdmZip(zipBuffer);\n  zip.extractAllTo(tempDir, true);\n  \n  return tempDir;\n}\n\n/**\n * Creates Probo fixtures that launch Chromium with extensions\n * \n * @param config Configuration options for the fixtures\n * @returns Extended test function with Probo fixtures\n */\nexport function createProboFixtures(config: ProboFixturesConfig = {}) {\n  const { showBrowserConsole = false, extensionsPath } = config;\n  \n  // Default extensions path\n  const defaultExtensionsPath = join(__dirname, '../loaded_extensions');\n  const extensionsDir = extensionsPath || defaultExtensionsPath;\n\n  return base.extend({\n    context: async ({headless}, use) => {\n      // Extract extensions\n      const extensionDirs: string[] = [];\n      \n      try {\n        const crxFile = join(extensionsDir, 'microsoft-single-sign-on.crx');\n        const extractedDir = extractCrxFile(crxFile);\n        extensionDirs.push(extractedDir);\n      } catch (error) {\n        console.warn('Could not load Microsoft SSO extension:', error);\n      }\n      \n      // Launch Chromium with extensions\n      const userDataDir = mkdtempSync(join(tmpdir(), 'probo-user-data-'));\n      \n      const context = await chromium.launchPersistentContext(userDataDir, {\n        headless, // Extensions work better in non-headless mode\n        args: [\n          ...extensionDirs.map(dir => `--load-extension=${dir}`),\n          '--disable-extensions-except=' + extensionDirs.join(','),\n          '--disable-web-security', // Allow extensions to work properly\n          '--disable-features=VizDisplayCompositor'\n        ]\n      });\n      \n      await use(context);\n      \n      // Cleanup\n      await context.close();\n    },\n    \n    page: async ({ context }, use) => {\n      const page = await context.newPage();\n      \n      // Set up console logging if requested\n      if (showBrowserConsole) {\n        page.on('console', msg => console.log('Browser console:', msg.text()));\n      }\n      \n      await use(page);\n      await page.close();\n    },\n  });\n}\n\n/**\n * Default Probo fixtures with standard configuration\n * Launches Chromium with Microsoft SSO extension\n */\nexport const test = createProboFixtures();\n\n/**\n * Re-export expect from Playwright for convenience\n */\nexport { expect } from '@playwright/test';\n"],"names":["base"],"mappings":";;;;;;;;AAOA,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAYtC;;;AAGG;AACH,SAAS,cAAc,CAAC,OAAe,EAAA;AACrC,IAAA,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;;AAGxC,IAAA,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC;AAClB,IAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE;AAC7C,QAAA,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE;YACtD,QAAQ,GAAG,CAAC,CAAC;YACb,MAAM;SACP;KACF;AAED,IAAA,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE;AACnB,QAAA,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;KAC3D;IAED,MAAM,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;;AAG/C,IAAA,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;;AAGhE,IAAA,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC;AAClC,IAAA,GAAG,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAEhC,IAAA,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;AAKG;AACa,SAAA,mBAAmB,CAAC,MAAA,GAA8B,EAAE,EAAA;IAClE,MAAM,EAAE,kBAAkB,GAAG,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC;;IAG9D,MAAM,qBAAqB,GAAG,IAAI,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC;AACtE,IAAA,MAAM,aAAa,GAAG,cAAc,IAAI,qBAAqB,CAAC;IAE9D,OAAOA,MAAI,CAAC,MAAM,CAAC;QACjB,OAAO,EAAE,OAAO,EAAC,QAAQ,EAAC,EAAE,GAAG,KAAI;;YAEjC,MAAM,aAAa,GAAa,EAAE,CAAC;AAEnC,YAAA,IAAI;gBACF,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,EAAE,8BAA8B,CAAC,CAAC;AACpE,gBAAA,MAAM,YAAY,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;AAC7C,gBAAA,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;aAClC;YAAC,OAAO,KAAK,EAAE;AACd,gBAAA,OAAO,CAAC,IAAI,CAAC,yCAAyC,EAAE,KAAK,CAAC,CAAC;aAChE;;AAGD,YAAA,MAAM,WAAW,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;YAEpE,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,uBAAuB,CAAC,WAAW,EAAE;AAClE,gBAAA,QAAQ;AACR,gBAAA,IAAI,EAAE;oBACJ,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,IAAI,CAAA,iBAAA,EAAoB,GAAG,CAAA,CAAE,CAAC;AACtD,oBAAA,8BAA8B,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC;AACxD,oBAAA,wBAAwB;oBACxB,yCAAyC;AAC1C,iBAAA;AACF,aAAA,CAAC,CAAC;AAEH,YAAA,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC;;AAGnB,YAAA,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;SACvB;QAED,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,GAAG,KAAI;AAC/B,YAAA,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;;YAGrC,IAAI,kBAAkB,EAAE;gBACtB,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;aACxE;AAED,YAAA,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC;AAChB,YAAA,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;SACpB;AACF,KAAA,CAAC,CAAC;AACL,CAAC;AAED;;;AAGG;AACU,MAAA,IAAI,GAAG,mBAAmB;;;;"}

package/dist/index.d.ts

@@ -98,9 +98,9 @@ interface RunStepParams extends Partial<PlaywrightTimeoutConfig> {
     timeout?: number;
 }
 declare class ProboPlaywright {
-    private readonly config;
+    private readonly timeoutConfig;
     private page;
-    constructor(config?: PlaywrightTimeoutConfig, page?: Page$1 | null);
+    constructor(timeoutConfig?: Partial<PlaywrightTimeoutConfig>, page?: Page$1 | null);
     /**
      * Sets the Playwright page instance for this ProboPlaywright instance.
      * Also applies the configured default navigation and action timeouts to the page.
@@ -140,6 +140,7 @@ declare class ProboPlaywright {
      * @param value - The text value to fill into the input field
      */
     private robustFill;
+    private robustTypeKeys;
     /**
      * Performs a robust click operation using multiple fallback strategies.
      * Attempts standard click first, then mouse click at center coordinates, and finally native DOM events.
@@ -296,13 +297,19 @@ declare class OTP {
     static fetchAllInboxMessages(limit?: number, sort?: 'ascending' | 'descending', full?: boolean): Promise<MailinatorMessage[]>;
     /**
      * Waits for an OTP to arrive in the inbox and extracts it
-     * @param inbox - The inbox name to monitor (optional - if not provided, searches all inboxes)
-     * @param timeout - Maximum time to wait in milliseconds (default: 30000)
-     * @param checkInterval - How often to check in milliseconds (default: 1000)
-     * @param checkRecentMessagesSinceMs - When > 0, check messages from the last X milliseconds and return the most recent OTP (default: 0)
+     * @param options - Configuration options for waiting for OTP
+     * @param options.inbox - The inbox name to monitor (optional - if not provided, searches all inboxes)
+     * @param options.timeout - Maximum time to wait in milliseconds (default: 30000)
+     * @param options.checkInterval - How often to check in milliseconds (default: 1000)
+     * @param options.checkRecentMessagesSinceMs - When > 0, check messages from the last X milliseconds and return the most recent OTP (default: 0)
      * @returns Promise<string | null> - The extracted OTP code or null if timeout/no OTP found
      */
-    static waitForOTP(inbox?: string, timeout?: number, checkInterval?: number, checkRecentMessagesSinceMs?: number): Promise<string | null>;
+    static waitForOTP(options?: {
+        inbox?: string;
+        timeout?: number;
+        checkInterval?: number;
+        checkRecentMessagesSinceMs?: number;
+    }): Promise<string | null>;
 }
 
 /**
@@ -320,10 +327,13 @@ interface ProboConfig {
     timeoutConfig?: Partial<PlaywrightTimeoutConfig>;
 }
 interface RunStepOptions {
-    useCache: boolean;
-    stepIdFromServer?: number | null;
     aiModel?: AIModel;
     timeoutConfig?: PlaywrightTimeoutConfig;
+    stepId?: number;
+}
+interface AskAIOptions {
+    stepId?: number;
+    createStep?: boolean;
 }
 declare class Probo {
     private highlighter;
@@ -333,10 +343,9 @@ declare class Probo {
     private readonly aiModel;
     private readonly timeoutConfig;
     constructor({ scenarioName, token, apiUrl, enableConsoleLogs, logToConsole, logToFile, debugLevel, aiModel, timeoutConfig }: ProboConfig);
-    askAI(page: Page, question: string): Promise<any>;
-    runStep(page: Page, stepPrompt: string, argument?: string | boolean | null, options?: RunStepOptions): Promise<boolean | string | null>;
+    askAI(page: Page, question: string, options: AskAIOptions): Promise<any>;
+    runStep(page: Page, stepPrompt: string, argument?: string | boolean | null, options?: RunStepOptions): Promise<string | void>;
     private _handleCachedStep;
-    private _handleStepCreation;
     private setupConsoleLogs;
     getInitialPageState(page: Page): Promise<InitialPageState>;
     findAndHighlightCandidateElements(page: Page, elementTags: string[]): Promise<FindCandidateInput>;
@@ -346,8 +355,8 @@ declare class Probo {
     waitForMutationsToSettle(page: Page, timeout?: number, initTimeout?: number): Promise<boolean>;
     screenshot(page: Page): Promise<string>;
     private _handlePerformAction;
-    askAIHelper(page: Page, question: string): Promise<ServerResponse>;
+    askAIHelper(page: Page, question: string, options: AskAIOptions): Promise<ServerResponse>;
 }
 
 export { Highlighter, NavTracker, OTP, Probo, ProboPlaywright, findClosestVisibleElement };
-export type { ElementTagType, MailinatorMessage, RunStepOptions };
+export type { AskAIOptions, ElementTagType, MailinatorMessage, RunStepOptions };