testdriverai 7.1.2 → 7.1.4

package/.github/workflows/test-init.yml

@@ -0,0 +1,145 @@
+name: Test Init Command
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+  workflow_dispatch:
+
+jobs:
+  test-init:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - name: Checkout CLI repository
+      uses: actions/checkout@v4
+    
+    - name: Setup Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: '20'
+        cache: 'npm'
+    
+    - name: Install CLI dependencies
+      run: npm ci
+    
+    - name: Create test directory
+      run: |
+        mkdir -p /tmp/test-init-project
+        cd /tmp/test-init-project
+    
+    - name: Run init command (skip prompts)
+      working-directory: /tmp/test-init-project
+      run: |
+        # Create .env with API key first to skip the prompt
+        echo "TD_API_KEY=${{ secrets.TD_API_KEY }}" > .env
+        
+        # Run init command using the CLI from the repo
+        node ${{ github.workspace }}/bin/testdriverai.js init
+      env:
+        TD_API_KEY: ${{ secrets.TD_API_KEY }}
+    
+    - name: Verify project structure
+      working-directory: /tmp/test-init-project
+      run: |
+        echo "Checking generated files..."
+        
+        # Check for package.json
+        if [ ! -f "package.json" ]; then
+          echo "❌ package.json not found"
+          exit 1
+        fi
+        echo "✓ package.json exists"
+        
+        # Check for vitest config
+        if [ ! -f "vitest.config.js" ]; then
+          echo "❌ vitest.config.js not found"
+          exit 1
+        fi
+        echo "✓ vitest.config.js exists"
+        
+        # Check for test file
+        if [ ! -f "tests/example.test.js" ]; then
+          echo "❌ tests/example.test.js not found"
+          exit 1
+        fi
+        echo "✓ tests/example.test.js exists"
+        
+        # Check for .env file
+        if [ ! -f ".env" ]; then
+          echo "❌ .env not found"
+          exit 1
+        fi
+        echo "✓ .env exists"
+        
+        # Check for .gitignore
+        if [ ! -f ".gitignore" ]; then
+          echo "❌ .gitignore not found"
+          exit 1
+        fi
+        echo "✓ .gitignore exists"
+        
+        # Check for GitHub workflow
+        if [ ! -f ".github/workflows/testdriver.yml" ]; then
+          echo "❌ .github/workflows/testdriver.yml not found"
+          exit 1
+        fi
+        echo "✓ .github/workflows/testdriver.yml exists"
+    
+    - name: Verify vitest config contents
+      working-directory: /tmp/test-init-project
+      run: |
+        echo "Checking vitest.config.js contents..."
+        
+        # Check for TestDriver reporter
+        if ! grep -q "TestDriver()" vitest.config.js; then
+          echo "❌ TestDriver reporter not found in vitest.config.js"
+          cat vitest.config.js
+          exit 1
+        fi
+        echo "✓ TestDriver reporter is configured"
+        
+        # Check for setupFiles
+        if ! grep -q "setupFiles.*testdriverai/vitest/setup" vitest.config.js; then
+          echo "❌ setupFiles not configured correctly"
+          cat vitest.config.js
+          exit 1
+        fi
+        echo "✓ setupFiles is configured"
+    
+    - name: Verify test file contents
+      working-directory: /tmp/test-init-project
+      run: |
+        echo "Checking test file contents..."
+        
+        # Check for .provision usage
+        if ! grep -q "\.provision\.chrome" tests/example.test.js; then
+          echo "❌ Test does not use .provision.chrome"
+          cat tests/example.test.js
+          exit 1
+        fi
+        echo "✓ Test uses .provision.chrome"
+        
+        # Check for TestDriver import
+        if ! grep -q "from 'testdriverai/vitest/hooks'" tests/example.test.js; then
+          echo "❌ Test does not import from testdriverai/vitest/hooks"
+          cat tests/example.test.js
+          exit 1
+        fi
+        echo "✓ Test imports TestDriver from vitest/hooks"
+    
+    - name: Run the generated test
+      working-directory: /tmp/test-init-project
+      run: npm test
+      env:
+        TD_API_KEY: ${{ secrets.TD_API_KEY }}
+    
+    - name: Upload test results
+      if: always()
+      uses: actions/upload-artifact@v4
+      with:
+        name: test-init-results
+        path: /tmp/test-init-project/test-results/
+        retention-days: 7
+        if-no-files-found: warn

package/agent/lib/commander.js

@@ -178,9 +178,9 @@ commands:
           emitter.emit(events.log.log, generator.jsonToManual(object));
           response = await commands["focus-application"](object.name);
           break;
-        case "remember": {
+        case "extract": {
           emitter.emit(events.log.log, generator.jsonToManual(object));
-          let value = await commands["remember"](object.description);
+          let value = await commands["extract"](object.description);
           emitter.emit(events.log.log, value);
           outputsInstance.set(object.output, value);
           break;

package/agent/lib/commands.js

@@ -283,6 +283,11 @@ const createCommands = (
    * @param {number} [options.redraw.diffThreshold=0.1] - Screen diff threshold percentage
    */
   const scroll = async (direction = 'down', options = {}) => {
+    // Convert number to object format
+    if (typeof options === 'number') {
+      options = { amount: options };
+    }
+    
     let { amount = 300 } = options;
     const redrawOptions = extractRedrawOptions(options);
     
@@ -1151,7 +1156,7 @@ const createCommands = (
             ),
             true,
           );
-          await scroll({ direction, amount: incrementDistance });
+          await scroll(direction, { amount: incrementDistance });
           scrollDistance = scrollDistance + incrementDistance;
         }
       }
@@ -1231,7 +1236,7 @@ const createCommands = (
             theme.dim(`scrolling ${direction} ${incrementDistance} pixels...`),
             true,
           );
-          await scroll({ direction, amount: incrementDistance });
+          await scroll(direction, { amount: incrementDistance });
           scrollDistance = scrollDistance + incrementDistance;
         }
       }
@@ -1271,11 +1276,11 @@ const createCommands = (
       return "The application was focused.";
     },
     /**
-     * Extract and remember information from the screen using AI
+     * Extract information from the screen using AI
      * @param {Object|string} options - Options object or description (for backward compatibility)
-     * @param {string} options.description - What to remember
+     * @param {string} options.description - What to extract
      */
-    "remember": async (...args) => {
+    "extract": async (...args) => {
       const rememberStartTime = Date.now();
       let description;
       

package/docs/docs.json

@@ -232,8 +232,28 @@
                   "/v7/presets/chrome",
                   "/v7/presets/chrome-extension",
                   "/v7/presets/vscode",
-                  "/v7/presets/electron",
-                  "/v7/presets/webapp"
+                  "/v7/presets/electron"
+                ]
+              },
+              {
+                "group": "Actions",
+                "icon": "bolt",
+                "pages": [
+                  "/v7/api/act",
+                  "/v7/api/assert",
+                  "/v7/api/assertions",
+                  "/v7/api/click",
+                  "/v7/api/doubleClick",
+                  "/v7/api/exec",
+                  "/v7/api/find",
+                  "/v7/api/focusApplication",
+                  "/v7/api/hover",
+                  "/v7/api/mouseDown",
+                  "/v7/api/mouseUp",
+                  "/v7/api/pressKeys",
+                  "/v7/api/rightClick",
+                  "/v7/api/type",
+                  "/v7/api/scroll"
                 ]
               },
               {
@@ -241,35 +261,8 @@
                 "icon": "book",
                 "pages": [
                   "/v7/api/client",
+                  "/v7/api/elements",
                   "/v7/api/sandbox",
-                  {
-                    "group": "Interactions",
-                    "icon": "bolt",
-                    "pages": [
-                      "/v7/api/find",
-                      "/v7/api/elements",
-                      "/v7/api/click",
-                      "/v7/api/doubleClick",
-                      "/v7/api/rightClick",
-                      "/v7/api/hover",
-                      "/v7/api/mouseDown",
-                      "/v7/api/mouseUp",
-                      "/v7/api/type",
-                      "/v7/api/pressKeys",
-                      "/v7/api/scroll",
-                      "/v7/api/focusApplication"
-                    ]
-                  },
-                  {
-                    "group": "AI & Assertions",
-                    "icon": "wand-magic-sparkles",
-                    "pages": [
-                      "/v7/api/act",
-                      "/v7/api/assert",
-                      "/v7/api/assertions"
-                    ]
-                  },
-                  "/v7/api/exec",
                   "/v7/api/dashcam"
                 ]
               }
@@ -313,64 +306,16 @@
   },
   "redirects": [
     {
-      "source": "/overview/:slug*",
-      "destination": "/v6/overview/:slug*"
-    },
-    {
-      "source": "/features/:slug*",
-      "destination": "/v6/features/:slug*"
-    },
-    {
-      "source": "/account/:slug*",
-      "destination": "/v6/account/:slug*"
-    },
-    {
-      "source": "/cli/:slug*",
-      "destination": "/v6/cli/:slug*"
-    },
-    {
-      "source": "/interactive/:slug*",
-      "destination": "/v6/interactive/:slug*"
-    },
-    {
-      "source": "/getting-started/:slug*",
-      "destination": "/v6/getting-started/:slug*"
-    },
-    {
-      "source": "/apps/:slug*",
-      "destination": "/v6/apps/:slug*"
-    },
-    {
-      "source": "/scenarios/:slug*",
-      "destination": "/v6/scenarios/:slug*"
-    },
-    {
-      "source": "/integrations/:slug*",
-      "destination": "/v6/integrations/:slug*"
-    },
-    {
-      "source": "/guide/:slug*",
-      "destination": "/v6/guide/:slug*"
-    },
-    {
-      "source": "/action/:slug*",
-      "destination": "/v6/action/:slug*"
-    },
-    {
-      "source": "/importing/:slug*",
-      "destination": "/v6/importing/:slug*"
-    },
-    {
-      "source": "/exporting/:slug*",
-      "destination": "/v6/exporting/:slug*"
+      "source": "/guides/github-actions",
+      "destination": "/action/setup"
     },
     {
-      "source": "/bugs/:slug*",
-      "destination": "/v6/bugs/:slug*"
+      "source": "/reference/test-steps",
+      "destination": "/features/selectorless"
     },
     {
-      "source": "/commands/:slug*",
-      "destination": "/v6/commands/:slug*"
+      "source": "/guides/debugging-test-runs",
+      "destination": "/getting-started/editing"
     }
   ],
   "integrations": {

package/docs/v7/_drafts/migration.mdx

@@ -207,16 +207,16 @@ await testdriver.focusApplication('Google Chrome');
 ```
 </CodeGroup>
 
-### Remember
+### Extract
 
 <CodeGroup>
 ```yaml YAML
-- command: remember
+- command: extract
   description: the order number
 ```
 
 ```javascript SDK
-const orderNumber = await testdriver.remember('the order number');
+const orderNumber = await testdriver.extract('the order number');
 ```
 </CodeGroup>
 

package/docs/v7/api/act.mdx

@@ -202,4 +202,4 @@ describe('E-commerce Flow with AI', () => {
 
 - [`find()`](/v7/api/find) - Locate specific elements
 - [`assert()`](/v7/api/assert) - Make assertions
-- [`remember()`](/v7/api/remember) - Extract information
+- [`extract()`](/v7/api/extract) - Extract information

package/docs/v7/api/assert.mdx

@@ -280,6 +280,6 @@ describe('Assertions', () => {
 
 ## Related Methods
 
-- [`remember()`](/v7/api/remember) - Extract information for detailed assertions
+- [`extract()`](/v7/api/extract) - Extract information for detailed assertions
 - [`find()`](/v7/api/find) - Locate elements to verify
 - [`ai()`](/v7/api/ai) - Complex AI-driven tasks

package/docs/v7/api/assertions.mdx

@@ -77,12 +77,12 @@ await waitForAssertion(testdriver, 'results are displayed', 10000);
 
 ## Extracting Information
 
-### remember()
+### extract()
 
-Extract and remember information from the screen using AI.
+Extract information from the screen using AI.
 
 ```javascript
-await testdriver.remember(description)
+await testdriver.extract(description)
 ```
 
 **Parameters:**
@@ -94,17 +94,17 @@ await testdriver.remember(description)
 
 ```javascript
 // Extract text from screen
-const password = await testdriver.remember('the password displayed on screen');
-const total = await testdriver.remember('the order total amount');
-const errorMessage = await testdriver.remember('the error message text');
+const password = await testdriver.extract('the password displayed on screen');
+const total = await testdriver.extract('the order total amount');
+const errorMessage = await testdriver.extract('the error message text');
 
 // Extract structured data
-const email = await testdriver.remember('the email address in the confirmation');
-const orderId = await testdriver.remember('the order ID number');
-const phoneNumber = await testdriver.remember('the phone number');
+const email = await testdriver.extract('the email address in the confirmation');
+const orderId = await testdriver.extract('the order ID number');
+const phoneNumber = await testdriver.extract('the phone number');
 
 // Use extracted data
-const password = await testdriver.remember('the password for standard_user');
+const password = await testdriver.extract('the password for standard_user');
 const passwordField = await testdriver.find('password input');
 await passwordField.click();
 await testdriver.type(password);
@@ -114,8 +114,8 @@ await testdriver.type(password);
 
 **Dynamic Content:**
 ```javascript
-// Remember generated values
-const confirmationCode = await testdriver.remember('the 6-digit confirmation code');
+// Extract generated values
+const confirmationCode = await testdriver.extract('the 6-digit confirmation code');
 console.log('Code:', confirmationCode);
 
 // Use it later in the test
@@ -125,7 +125,7 @@ await testdriver.type(confirmationCode);
 **Verification:**
 ```javascript
 // Extract and verify
-const displayedTotal = await testdriver.remember('the cart total');
+const displayedTotal = await testdriver.extract('the cart total');
 const expectedTotal = '$99.99';
 
 expect(displayedTotal).toBe(expectedTotal);
@@ -134,7 +134,7 @@ expect(displayedTotal).toBe(expectedTotal);
 **Conditional Logic:**
 ```javascript
 // Extract state and make decisions
-const status = await testdriver.remember('the order status');
+const status = await testdriver.extract('the order status');
 
 if (status.includes('Pending')) {
   // Wait for processing

package/docs/v7/getting-started/quickstart.mdx

@@ -44,14 +44,16 @@ TestDriver v7 lets you write AI-powered tests in JavaScript/TypeScript with full
       <Tab title="Fast">
         ```javascript test.test.js
         import { test } from 'vitest';
-        import { chrome } from 'testdriverai/presets';
+        import { TestDriver } from 'testdriverai/vitest/hooks';
 
         test('my first test', async (context) => {
-          const { testdriver } = await chrome(context, {
-            url: 'https://example.com',
+          const testdriver = TestDriver(context, {
+            headless: true,
             apiKey: 'tdai-1234567890abcdef' // Your API key from console.testdriver.ai
           });
           
+          await testdriver.provision.chrome({ url: 'https://example.com' });
+          
           await testdriver.find('More information link').click();
           await testdriver.assert('IANA page is visible');
         });
@@ -73,13 +75,13 @@ TestDriver v7 lets you write AI-powered tests in JavaScript/TypeScript with full
         
         ```javascript test.test.js
         import { test } from 'vitest';
-        import { chrome } from 'testdriverai/presets';
+        import { TestDriver } from 'testdriverai/vitest/hooks';
 
         test('my first test', async (context) => {
-          const { testdriver } = await chrome(context, {
-            url: 'https://example.com'
-            // apiKey automatically read from process.env.TD_API_KEY
-          });
+          const testdriver = TestDriver(context, { headless: true });
+          // apiKey automatically read from process.env.TD_API_KEY
+          
+          await testdriver.provision.chrome({ url: 'https://example.com' });
           
           await testdriver.find('More information link').click();
           await testdriver.assert('IANA page is visible');
@@ -111,7 +113,7 @@ TestDriver v7 lets you write AI-powered tests in JavaScript/TypeScript with full
 
 ## What Just Happened?
 
-The `chrome()` preset automatically:
+The TestDriver hook with `provision.chrome()` automatically:
 1. ✅ Connected to a TestDriver sandbox
 2. ✅ Launched Chrome browser
 3. ✅ Navigated to your URL

package/docs/v7/getting-started/running-and-debugging.mdx

@@ -101,11 +101,12 @@ Every test automatically records a video replay:
   <Step title="Get Replay URL">
     ```javascript
     test('my test', async (context) => {
-      const { testdriver, dashcam } = await chrome(context, { url });
+      const testdriver = TestDriver(context, { headless: true });
+      await testdriver.provision.chrome({ url });
 
       // Your test code
 
-      console.log('Replay:', dashcam.url);
+      console.log('Replay:', testdriver.dashcam.url);
     });
     ```
 

package/docs/v7/getting-started/writing-tests.mdx

@@ -12,13 +12,12 @@ Every TestDriver test follows this simple pattern:
 
 ```javascript
 import { test } from 'vitest';
-import { chrome } from 'testdriverai/presets';
+import { TestDriver } from 'testdriverai/vitest/hooks';
 
 test('descriptive test name', async (context) => {
   // 1. Setup: Launch and navigate
-  const { testdriver } = await chrome(context, {
-    url: 'https://myapp.com'
-  });
+  const testdriver = TestDriver(context, { headless: true });
+  await testdriver.provision.chrome({ url: 'https://myapp.com' });
 
   // 2. Act: Interact with your application
   await testdriver.find('email input').type('user@example.com');
@@ -30,7 +29,7 @@ test('descriptive test name', async (context) => {
 ```
 
 <Tip>
-  The preset handles all setup and cleanup automatically - no need for manual browser management!
+  The TestDriver hook handles all setup and cleanup automatically - no need for manual browser management!
 </Tip>
 
 ## Finding Elements

package/docs/v7/overview/readme.mdx

@@ -75,7 +75,7 @@ v7/
   - Basic assertions
   - Negative assertions (invert parameter)
   - Async assertions
-- `remember()` - Extract information from screen
+- `extract()` - Extract information from screen
 - Testing patterns:
   - Polling assertions
   - Multi-step validation