testdriverai 7.2.41 → 7.2.43

package/agents.md

@@ -41,8 +41,8 @@ import { TestDriver } from "testdriverai/lib/vitest/hooks.mjs";
 
 describe("My Test Suite", () => {
   it("should do something", async (context) => {
-    // Initialize TestDriver with options
-    const testdriver = TestDriver(context, { newSandbox: true, headless: false });
+    // Initialize TestDriver
+    const testdriver = TestDriver(context);
     
     // Start with provision - this launches the sandbox and browser
     await testdriver.provision.chrome({
@@ -175,10 +175,7 @@ describe("Setup State", () => {
   });
 
   it("should set up the application state", async (context) => {
-    const testdriver = TestDriver(context, { 
-      newSandbox: true, 
-      headless: false 
-    });
+    const testdriver = TestDriver(context);
     
     await testdriver.provision.chrome({
       url: 'https://your-app.com/login',
@@ -219,8 +216,6 @@ describe("Experiment", () => {
 
   it("should continue from existing state", async (context) => {
     const testdriver = TestDriver(context, { 
-      newSandbox: true, 
-      headless: false,
       reconnect: true  // ← Key: reconnects to last sandbox
     });
     
@@ -278,7 +273,7 @@ import { TestDriver } from "testdriverai/lib/vitest/hooks.mjs";
 
 describe("Login Flow", () => {
   it("should log in and open settings", async (context) => {
-    const testdriver = TestDriver(context, { newSandbox: true, headless: false });
+    const testdriver = TestDriver(context);
     
     await testdriver.provision.chrome({ url: 'https://your-app.com/login' });
 
@@ -310,7 +305,7 @@ describe("Login Flow", () => {
 ```javascript
 // Development workflow example
 it("should incrementally build test", async (context) => {
-  const testdriver = TestDriver(context, { newSandbox: true });
+  const testdriver = TestDriver(context);
   await testdriver.provision.chrome({ url: 'https://example.com' });
 
   // Step 1: Find and inspect

package/docs/docs.json

@@ -288,7 +288,7 @@
       },
       {
         "label": "Book a Demo",
-        "href": "https://form.typeform.com/to/UECf9rDx?typeform-source=docs.testdriver.ai",
+        "href": "http://testdriver.ai/demo",
         "icon": "calendar"
       },
       {

package/docs/v6/getting-started/self-hosting.mdx

@@ -47,7 +47,7 @@ The setup process involves three main steps:
     Be sure to run `aws configure` with your credentials
   </Tip>
 - Access to the TestDriver AMI (Golden Image is `ami-086b5b4b86d78987c`)\
-  [Contact us with your preferred AWS Region for access](https://form.typeform.com/to/UECf9rDx?typeform-source=testdriver.ai).
+  [Contact us with your preferred AWS Region for access](http://testdriver.ai/demo).
 - A GitHub repository for committing your tests & workflow.
 
 ## Step 1: Set Up AWS Infrastructure

package/docs/v7/_drafts/screenshot.mdx

@@ -113,7 +113,7 @@ const screenshot = await testdriver.screenshot(1, false, true);
 
 ```javascript
 it('should complete checkout', async (context) => {
-  const testdriver = TestDriver(context, ());
+  const testdriver = TestDriver(context);
   await testdriver.provision.chrome({ url: 'https://shop.example.com' });
 
   try {

package/docs/v7/_drafts/self-hosting.mdx

@@ -47,7 +47,7 @@ The setup process involves three main steps:
     Be sure to run `aws configure` with your credentials
   </Tip>
 - Access to the TestDriver AMI (Golden Image is `ami-055cd47506a2f39bb`)\
-  [Contact us with your preferred AWS Region for access](https://form.typeform.com/to/UECf9rDx?typeform-source=testdriver.ai).
+  [Contact us with your preferred AWS Region for access](http://testdriver.ai/demo).
 - A GitHub repository for committing your tests & workflow.
 
 ## Step 1: Set Up AWS Infrastructure

package/docs/v7/ai.mdx

@@ -167,7 +167,7 @@ describe('E-commerce Flow with AI', () => {
   beforeAll(async () => {
     client = new TestDriver(process.env.TD_API_KEY);
     await testdriver.auth();
-    await testdriver.connect(());
+    await testdriver.connect();
   });
 
   afterAll(async () => {

package/docs/v7/assert.mdx

@@ -214,7 +214,7 @@ describe('Assertions', () => {
   beforeAll(async () => {
     client = new TestDriver(process.env.TD_API_KEY);
     await testdriver.auth();
-    await testdriver.connect(());
+    await testdriver.connect();
   });
 
   afterAll(async () => {

package/docs/v7/aws-setup.mdx

@@ -40,7 +40,7 @@ Before you begin, ensure you have:
 
 - AWS account with CloudFormation permissions
 - [AWS CLI](https://aws.amazon.com/cli/) installed and configured (`aws configure`)
-- Access to the TestDriver AMI — [Contact us](https://form.typeform.com/to/UECf9rDx?typeform-source=testdriver.ai) with your AWS region
+- Access to the TestDriver AMI — [Contact us](http://testdriver.ai/demo) with your AWS region
 - A GitHub repository for your tests
 
 <Tip>

package/docs/v7/click.mdx

@@ -235,7 +235,7 @@ describe('Click Interactions', () => {
   beforeAll(async () => {
     client = new TestDriver(process.env.TD_API_KEY);
     await testdriver.auth();
-    await testdriver.connect(());
+    await testdriver.connect();
   });
 
   afterAll(async () => {

package/docs/v7/client.mdx

@@ -133,7 +133,7 @@ await testdriver.connect(options)
 
 **Basic connection:**
 ```javascript
-await testdriver.connect(());
+await testdriver.connect();
 ```
 
 **Reconnect to existing sandbox:**
@@ -273,7 +273,7 @@ describe('My Test Suite', () => {
     
     // Authenticate and connect
     await testdriver.auth();
-    const instance = await testdriver.connect(());
+    const instance = await testdriver.connect();
     
     console.log('Connected to sandbox:', instance.instanceId);
   });
@@ -300,7 +300,7 @@ describe('My Test Suite', () => {
     
     ```javascript
     try {
-      await testdriver.connect(());
+      await testdriver.connect();
     } catch (error) {
       console.error('Failed to connect:', error.message);
       throw error;

package/docs/v7/customizing-devices.mdx

@@ -14,6 +14,26 @@ const testdriver = TestDriver(context, {
 });
 ```
 
+### Headless Mode
+
+Run tests without a visible browser window. Useful for CI/CD pipeline or spawning multiple tests locally:
+
+```javascript
+const testdriver = TestDriver(context, {
+  headless: true,  // No visible browser window
+});
+```
+
+### IP Target
+
+If self-hosting TestDriver, use `ip` to specify the device IP. See [Self-Hosting TestDriver](../self-hosting.md) for details.
+
+```javascript
+const testdriver = TestDriver(context, {
+  ip: "203.0.113.42",  // Your allowlisted IP
+});
+```
+
 ### Operating System
 
 Set the `os` property to run tests on a specific operating system. Available options are `linux` (default) and `windows`.

package/docs/v7/device-config.mdx

@@ -32,7 +32,7 @@ import { TestDriver } from "testdriverai/lib/vitest/hooks.mjs";
 
 describe("Login Flow", () => {
   it("should log in successfully", async (context) => {
-    const testdriver = TestDriver(context, ());
+    const testdriver = TestDriver(context);
     
     await testdriver.provision.chrome({
       url: 'https://myapp.com/login',
@@ -117,7 +117,7 @@ import { TestDriver } from "testdriverai/lib/vitest/hooks.mjs";
 
 describe("Chrome Extension Test", () => {
   it("should load and interact with extension", async (context) => {
-    const testdriver = TestDriver(context, ());
+    const testdriver = TestDriver(context);
 
     // Clone extension from GitHub
     await testdriver.ready();
@@ -192,7 +192,7 @@ import { TestDriver } from "testdriverai/lib/vitest/hooks.mjs";
 
 describe("Desktop App Test", () => {
   it("should install and launch app", async (context) => {
-    const testdriver = TestDriver(context, ());
+    const testdriver = TestDriver(context);
 
     // Download and install
     const installerPath = await testdriver.provision.installer({
@@ -281,7 +281,7 @@ import { TestDriver } from "testdriverai/lib/vitest/hooks.mjs";
 
 describe("VS Code Test", () => {
   it("should open workspace with extensions", async (context) => {
-    const testdriver = TestDriver(context, ());
+    const testdriver = TestDriver(context);
 
     // Create a test project
     await testdriver.ready();

package/docs/v7/exec.mdx

@@ -282,7 +282,7 @@ describe('Code Execution', () => {
   beforeAll(async () => {
     client = new TestDriver(process.env.TD_API_KEY);
     await testdriver.auth();
-    await testdriver.connect(());
+    await testdriver.connect();
   });
 
   afterAll(async () => {

package/docs/v7/find.mdx

@@ -299,7 +299,7 @@ describe('Element Finding', () => {
   beforeAll(async () => {
     client = new TestDriver(process.env.TD_API_KEY);
     await testdriver.auth();
-    await testdriver.connect(());
+    await testdriver.connect();
   });
 
   afterAll(async () => {

package/docs/v7/focus-application.mdx

@@ -209,7 +209,7 @@ describe('Multi-Application Workflow', () => {
   beforeAll(async () => {
     client = new TestDriver(process.env.TD_API_KEY);
     await testdriver.auth();
-    await testdriver.connect(());
+    await testdriver.connect();
   });
 
   afterAll(async () => {

package/docs/v7/hover.mdx

@@ -204,7 +204,7 @@ describe('Hover Interactions', () => {
   beforeAll(async () => {
     client = new TestDriver(process.env.TD_API_KEY);
     await testdriver.auth();
-    await testdriver.connect(());
+    await testdriver.connect();
   });
 
   afterAll(async () => {

package/docs/v7/press-keys.mdx

@@ -286,7 +286,7 @@ describe('Keyboard Navigation', () => {
   beforeAll(async () => {
     client = new TestDriver(process.env.TD_API_KEY);
     await testdriver.auth();
-    await testdriver.connect(());
+    await testdriver.connect();
   });
 
   afterAll(async () => {

package/docs/v7/reusable-code.mdx

@@ -45,7 +45,7 @@ import { login } from './helpers/auth.js';
 
 describe("Checkout", () => {
   it("should complete checkout as logged in user", async (context) => {
-    const testdriver = TestDriver(context, ());
+    const testdriver = TestDriver(context);
     
     await testdriver.provision.chrome({
       url: 'https://shop.example.com',
@@ -116,7 +116,7 @@ import { LoginPage } from './pages/LoginPage.js';
 
 describe("Authentication", () => {
   it("should show error for invalid credentials", async (context) => {
-    const testdriver = TestDriver(context, ());
+    const testdriver = TestDriver(context);
     
     await testdriver.provision.chrome({
       url: 'https://app.example.com/login',
@@ -131,7 +131,7 @@ describe("Authentication", () => {
   });
 
   it("should redirect to dashboard on success", async (context) => {
-    const testdriver = TestDriver(context, ());
+    const testdriver = TestDriver(context);
     
     await testdriver.provision.chrome({
       url: 'https://app.example.com/login',
@@ -186,7 +186,7 @@ import { testUsers, testUrls, setupAuthenticatedSession } from './fixtures/index
 
 describe("Admin Panel", () => {
   it("should access admin settings", async (context) => {
-    const testdriver = TestDriver(context, ());
+    const testdriver = TestDriver(context);
     
     await testdriver.provision.chrome({
       url: `${testUrls.staging}/login`,

package/docs/v7/scroll.mdx

@@ -242,7 +242,7 @@ describe('Scrolling', () => {
   beforeAll(async () => {
     client = new TestDriver(process.env.TD_API_KEY);
     await testdriver.auth();
-    await testdriver.connect(());
+    await testdriver.connect();
   });
 
   afterAll(async () => {

package/docs/v7/type.mdx

@@ -296,7 +296,7 @@ describe('Form Filling with Type', () => {
   beforeAll(async () => {
     client = new TestDriver(process.env.TD_API_KEY);
     await testdriver.auth();
-    await testdriver.connect(());
+    await testdriver.connect();
   });
 
   afterAll(async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "testdriverai",
-  "version": "7.2.41",
+  "version": "7.2.43",
   "description": "Next generation autonomous AI agent for end-to-end testing of web & desktop",
   "main": "sdk.js",
   "types": "sdk.d.ts",

package/sdk.js

@@ -2176,7 +2176,10 @@ with zipfile.ZipFile(io.BytesIO(zip_data)) as zf:
       ? connectOptions.reconnect 
       : this.reconnect;
     
-    if (shouldReconnect) {
+    // Skip reconnect if IP is supplied - directly connect to the provided IP
+    const hasIp = Boolean(connectOptions.ip || this.ip);
+    
+    if (shouldReconnect && !hasIp) {
       const lastSandbox = this.agent.getLastSandboxId();
       if (!lastSandbox || !lastSandbox.sandboxId) {
         throw new Error(

package/test/testdriver/assert.test.mjs

@@ -8,7 +8,7 @@ import { TestDriver } from "../../lib/vitest/hooks.mjs";
 
 describe("Assert Test", () => {
   it("should assert the testdriver login page shows", async (context) => {
-    const testdriver = TestDriver(context, {ip: process.env.TD_IP});
+    const testdriver = TestDriver(context);
     
     // provision.chrome() automatically calls ready() and starts dashcam
     await testdriver.provision.chrome({