@testdriverai/agent 7.11.240-test → 7.11.241-canary

package/ai/skills/testdriver-hosted/SKILL.md

@@ -1,155 +1,91 @@
 ---
 name: testdriver:hosted
-description: The fastest way to get started with TestDriver. Just set your API key and start testing.
+description: Run tests on TestDriver's cloud sandboxes, billed by testing minutes, with no infrastructure to manage.
 ---
 <!-- Generated from hosted.mdx. DO NOT EDIT. -->
 
-The hosted price uses **device-seconds**: the time that your tests run on **our infrastructure**.
+import { EnterpriseBadge, EnterpriseCta } from '/snippets/enterprise.mdx';
 
-- **Zero Setup**. Start tests immediately. You do not need DevOps.
-- **Free Tier** — Start with a limited preview at no cost.
-- **Pay As You Go** — Pay only for the device-seconds that you use.
+By default, your tests run on TestDriver's cloud. Each test gets a fresh sandbox, and you don't manage any machines.
 
-## Hosted Plans
+- Hosted is the default. When you follow the [Quickstart](/quickstart), you're using it.
+- You're billed in **testing minutes**: the time a sandbox is running.
+- Your plan sets how many sandboxes can run at the same time.
 
-<CardGroup cols={3}>
-  <Card title="Free Trial" icon="gift" href="https://docs.testdriver.ai">
-    **$0/month**
-    
-    - 1 Concurrent Sandbox
-    - 60 Minutes Included
-    - 1 Team User
-    - Community Support
+## Plans
+
+| | Free | Pro | Team |
+| --- | --- | --- | --- |
+| **Price** | $0 | $20 per seat per month | $600 per month |
+| **Testing minutes included** | 30 | 120 | 10,000 |
+| **Extra minutes** | Not available | $0.14 per minute | $0.14 per minute |
+| **Sandboxes at once** | 2 | 4 | 8 |
+| **Users** | Unlimited | One per seat | 5 |
+| **Test analytics** | No | Yes | Yes |
+| **CPU, RAM, and network profiles** | No | Yes | Yes |
+| **Support** | Community | Community | Private |
+
+<EnterpriseCta feature="Windows sandboxes, custom screen resolutions, and self-hosting" plural />
+
+Pro starts with a 14-day free trial. Start a plan from the [TestDriver console](https://console.testdriver.ai/checkout/pro).
+
+On the Free plan, new sandboxes are refused once you've used your 30 minutes. Upgrade to keep testing.
+
+<Note>
+  If you install TestDriver from GitHub Marketplace, GitHub bills you instead. The **Open Source** plan is free with 300 testing minutes per month. The **Team** plan is $20 per seat per month with 120 testing minutes per seat.
+</Note>
+
+## How testing minutes are counted
+
+Testing minutes run while a sandbox is running. That includes sandboxes started by:
+
+- Your test runs, locally and in CI.
+- The TestDriver agent, when it reviews a pull request or writes a test.
+
+A sandbox kept running with [`keepAlive`](/customizing-devices#keep-a-sandbox-alive) uses minutes until it shuts down. Keep `keepAlive` as short as you need.
+
+## Concurrency
+
+Each running sandbox uses one of your plan's slots. A slot frees up when its sandbox shuts down.
+
+When every slot is busy, a new test waits for a free slot instead of failing. The SDK retries every 10 seconds, for up to 60 seconds by default. Set `TD_CONCURRENCY_MAX_WAIT` to change the wait. See [Concurrency limits](/ci-cd#concurrency-limits).
+
+To stay within your slots, limit how many test files Vitest runs at once:
+
+```bash
+npx vitest run --maxWorkers=4
+```
+
+In GitHub Actions, a `concurrency` group stops two runs on the same branch from competing for slots. A new push cancels the older run:
+
+```yaml .github/workflows/testdriver.yml
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+```
+
+## When to self-host
+
+Consider [self-hosting](/self-hosted) when you need to:
+
+- Run tests on your own infrastructure, without per-minute billing.
+- Use your own AI provider keys.
+- Run custom VM images with your software preinstalled.
+- Run more tests in parallel than the hosted plans allow.
+
+## Next steps
+
+<CardGroup cols={2}>
+  <Card title="Quickstart" icon="play" href="/quickstart">
+    Run your first test on a hosted sandbox.
   </Card>
-  
-  <Card title="Pro" icon="rocket" href="https://console.testdriver.ai/checkout/pro">
-    **$20/month per user**
-    
-    - 2 Concurrent Sandboxes
-    - 120 Minutes Included
-    - Overage: $0.001/second
-    - Test Recordings
-    - Community Support
+  <Card title="Run tests in CI/CD" icon="code-branch" href="/ci-cd">
+    Run your tests on every push and pull request.
   </Card>
-  
-  <Card title="Team" icon="users" href="https://console.testdriver.ai/checkout/team">
-    **$600/month**
-    
-    - 8 Concurrent Sandboxes
-    - 10,000 Minutes Included
-    - Overage: $0.001/second
-    - 5 Team Users
-    - Test Recordings
-    - Private Support
-    - Test Analytics
-    - CPU, RAM, & Network Profiles
+  <Card title="Self-hosted" icon="server" href="/self-hosted">
+    Run sandboxes on your own infrastructure.
+  </Card>
+  <Card title="Run tests" icon="play" href="/copilot/running-tests">
+    Run tests locally and in parallel.
   </Card>
 </CardGroup>
-
-## Get Started
-Hosted is the default when you follow the Quickstart guide. 
-<Card
-  title="Try the Quickstart"  
-  icon="play"
-  href="/quickstart"
->
-  Set your API key and start testing in minutes.
-</Card>
-
-## Parallel Testing Limits
-
-Your account has a set number of **license slots** that determine how many devices can run simultaneously. You can view your available slots in the [TestDriver Dashboard](https://console.testdriver.ai).
-
-<Info>
-  **When is a slot in use?** A license slot is occupied when a test client is connected. As soon as your device is destroyed the slot becomes available immediately.
-</Info>
-
-## Avoiding Slot Conflicts
-
-To prevent tests from failing due to exceeding your license slot limit, we recommend two key configurations:
-
-<AccordionGroup>
-  <Accordion title="Set Maximum Concurrency in Vitest">
-    Limit concurrent tests to match your available license slots:
-
-    ```javascript vitest.config.mjs
-    import { defineConfig } from 'vitest/config';
-    import TestDriver from 'testdriverai/vitest';
-
-    export default defineConfig({
-      test: {
-        testTimeout: 900000,
-        hookTimeout: 900000,
-        maxConcurrency: 5, // Set to your license slot limit
-        reporters: ['default', TestDriver()],
-        setupFiles: ['testdriverai/vitest/setup'],
-      },
-    });
-    ```
-
-    <Tip>
-      Check your slot count at [console.testdriver.ai](https://console.testdriver.ai) and set `maxConcurrency` to that number or lower.
-    </Tip>
-  </Accordion>
-
-  <Accordion title="Use GitHub Concurrency Keys">
-    Prevent multiple workflow runs from competing for the same slots by using [GitHub's concurrency controls](https://docs.github.com/actions/writing-workflows/choosing-what-your-workflow-does/control-the-concurrency-of-workflows-and-jobs):
-
-    ```yaml .github/workflows/test.yml
-    name: Tests
-
-    on:
-      push:
-        branches: [main]
-      pull_request:
-
-    # Prevent concurrent runs from competing for license slots
-    concurrency:
-      group: ${{ github.workflow }}-${{ github.ref }}
-      cancel-in-progress: true
-
-    jobs:
-      test:
-        runs-on: ubuntu-latest
-        steps:
-          - uses: actions/checkout@v4
-          
-          - name: Setup Node.js
-            uses: actions/setup-node@v4
-            with:
-              node-version: '20'
-          
-          - name: Install dependencies
-            run: npm install
-          
-          - name: Run tests
-            run: vitest run
-            env:
-              TD_API_KEY: ${{ secrets.TD_API_KEY }}
-    ```
-
-    The `concurrency` block ensures:
-    - Only one workflow run per branch runs at a time
-    - New pushes cancel in-progress runs on the same branch
-    - Different branches/PRs can run in parallel (up to your slot limit)
-  </Accordion>
-</AccordionGroup>
-
-## When to Consider Self-Hosted
-
-Hosted is perfect for getting started and for teams that want zero infrastructure management. However, you might consider [Self-Hosted](/self-hosted) if you:
-
-- Want to escape per-second billing with a flat license fee
-- Require greater concurrency than offered in Cloud plans
-- Need full control over your infrastructure and privacy
-- Want to use your own AI API keys
-- Require custom hardware configurations
-- Have high test volumes that make self-hosting more economical
-
-<Card
-  title="Explore Self-Hosted"
-  icon="server"
-  href="/self-hosted"
->
-  Learn about self-hosting for unlimited test execution at a flat rate.
-</Card>

package/ai/skills/testdriver-hover/SKILL.md

@@ -1,278 +1,105 @@
 ---
 name: testdriver:hover
-description: Hover over elements or coordinates
+description: Move the mouse over an element or a point without clicking, to reveal tooltips and menus.
 ---
 <!-- Generated from hover.mdx. DO NOT EDIT. -->
 
-## Overview
-
-Move the mouse cursor onto elements or coordinates without a click. Use this to show tooltips, dropdowns, and hover effects.
-
-## Element Hover
-
-Put the cursor on a found element.
-
-### Syntax
+Move the mouse onto an element without clicking. Use it to reveal tooltips, dropdown menus and hover styles.
 
 ```javascript
-await element.hover()
+await testdriver.find('Products menu in the top navigation').hover();
+await testdriver.find('Laptops in the Products dropdown').click();
 ```
 
-### Returns
+## element.hover()
 
-`Promise<void>`
-
-### Examples
-
-```javascript
-// Find and hover
-const tooltip = await testdriver.find('info icon');
-await tooltip.hover();
+Moves the mouse to the point where [`find()`](/find) located the element. It's the same as `element.click('hover')`.
 
-// Wait to see tooltip
-await new Promise(r => setTimeout(r, 1000));
+```typescript
+element.hover(): Promise<void>
+```
 
-// Hover over menu to reveal submenu
-const menu = await testdriver.find('Products menu');
-await menu.hover();
+It takes no parameters.
 
-const submenu = await testdriver.find('Laptops submenu item');
-await submenu.click();
-```
+### Errors
 
-## Coordinate Hover
+Throws an `ElementNotFoundError` if `find()` didn't locate the element. See [click()](/click#errors) for how to check `found()` first.
 
-Put the cursor at screen coordinates.
+## testdriver.hover(options)
 
-### Syntax
+Moves the mouse to a point on the screen by its coordinates. Prefer `element.hover()`, which keeps working when the layout or screen size changes.
 
-```javascript
-await testdriver.hover(x, y)
+```typescript
+testdriver.hover(options: { x: number; y: number }): Promise<void>
 ```
 
-### Parameters
-
-<ParamField path="x" type="number" required>
-  X coordinate
+<ParamField path="options" type="object" required>
+  <Expandable title="properties">
+    <ParamField path="x" type="number" required>
+      Distance from the left edge of the screen, in pixels.
+    </ParamField>
+    <ParamField path="y" type="number" required>
+      Distance from the top edge of the screen, in pixels.
+    </ParamField>
+  </Expandable>
 </ParamField>
 
-<ParamField path="y" type="number" required>
-  Y coordinate
-</ParamField>
+```javascript
+await testdriver.hover({ x: 640, y: 360 });
+```
 
-### Returns
+<Note>
+  The older form `testdriver.hover(x, y)` still works. Use the options object in new tests.
+</Note>
 
-`Promise<void>`
+## Examples
 
-### Examples
+### Read a tooltip
 
 ```javascript
-// Hover at coordinates
-await testdriver.hover(500, 300);
-
-// Hover and wait
-await testdriver.hover(500, 300);
-await new Promise(r => setTimeout(r, 1000));
+await testdriver.find('help icon next to the Password label').hover();
+const tooltip = await testdriver.extract('the text of the tooltip');
 ```
 
-## Best Practices
-
-<Check>
-  **Prefer element hover over coordinates**
-  
-  ```javascript
-  // ✅ Preferred
-  const icon = await testdriver.find('info icon');
-  await icon.hover();
-  
-  // ❌ Avoid
-  await testdriver.hover(500, 300);
-  ```
-</Check>
-
-<Check>
-  **Wait after hovering for dynamic content**
-  
-  ```javascript
-  const menuItem = await testdriver.find('Settings menu');
-  await menuItem.hover();
-  
-  // Wait for submenu to appear
-  await new Promise(r => setTimeout(r, 500));
-  
-  const subItem = await testdriver.find('Profile submenu');
-  await subItem.click();
-  ```
-</Check>
+### Check a hover style
 
-<Check>
-  **Verify element was found before hovering**
-  
-  ```javascript
-  const element = await testdriver.find('tooltip trigger');
-  if (!element.found()) {
-    throw new Error('Element not found');
-  }
-  await element.hover();
-  ```
-</Check>
-
-## Use Cases
+```javascript
+await testdriver.find('Sign in button').hover();
+await testdriver.assert('the Sign in button is highlighted');
+```
 
-<AccordionGroup>
-  <Accordion title="Tooltips">
-    ```javascript
-    // Hover to show tooltip
-    const icon = await testdriver.find('help icon');
-    await icon.hover();
-    
-    await new Promise(r => setTimeout(r, 1000));
-    
-    // Read tooltip content
-    const tooltipText = await testdriver.extract('the tooltip text');
-    console.log('Tooltip:', tooltipText);
-    ```
-  </Accordion>
-  
-  <Accordion title="Dropdown Menus">
-    ```javascript
-    // Hover to reveal dropdown
-    const menuItem = await testdriver.find('Products menu item');
-    await menuItem.hover();
-    
-    // Wait for dropdown animation
-    await new Promise(r => setTimeout(r, 500));
-    
-    // Click submenu option
-    const category = await testdriver.find('Electronics category');
-    await category.click();
-    ```
-  </Accordion>
-  
-  <Accordion title="Image Previews">
-    ```javascript
-    // Hover over thumbnail to see preview
-    const thumbnail = await testdriver.find('product thumbnail');
-    await thumbnail.hover();
-    
-    await new Promise(r => setTimeout(r, 800));
-    
-    // Verify preview appears
-    await testdriver.assert('product preview is displayed');
-    ```
-  </Accordion>
-  
-  <Accordion title="Hover Effects">
-    ```javascript
-    // Test hover state styling
-    const button = await testdriver.find('call to action button');
-    await button.hover();
-    
-    await new Promise(r => setTimeout(r, 500));
-    
-    // Verify hover effect
-    await testdriver.assert('button background changed to blue');
-    ```
-  </Accordion>
-  
-  <Accordion title="Drag and Drop">
-    ```javascript
-    // Use hover in drag and drop
-    const item = await testdriver.find('draggable item');
-    await item.mouseDown();
-    
-    // Hover over drop zone
-    const dropZone = await testdriver.find('drop area');
-    await dropZone.hover();
-    
-    await new Promise(r => setTimeout(r, 300));
-    await dropZone.mouseUp();
-    ```
-  </Accordion>
-</AccordionGroup>
+### Drag an item
 
-## Complete Example
+`hover()` moves the mouse while the button is held down by [`mouseDown()`](/mouse-down):
 
 ```javascript
-import { beforeAll, afterAll, describe, it } from 'vitest';
-import TestDriver from 'testdriverai';
-
-describe('Hover Interactions', () => {
-  let testdriver;
+await testdriver.find('Task card titled "Write docs"').mouseDown();
+await testdriver.find('Done column').hover();
+await testdriver.find('Done column').mouseUp();
+```
 
-  beforeAll(async () => {
-    client = new TestDriver(process.env.TD_API_KEY);
-    await testdriver.auth();
-    await testdriver.connect();
-  });
+## Complete example
 
-  afterAll(async () => {
-    await testdriver.disconnect();
-  });
+```javascript tests/hover.test.mjs
+import { describe, expect, it } from 'vitest';
+import { TestDriver } from 'testdriverai/vitest/hooks';
 
-  it('should show tooltip on hover', async () => {
-    await testdriver.focusApplication('Google Chrome');
-    
-    // Find and hover over icon
-    const infoIcon = await testdriver.find('information icon');
-    await infoIcon.hover();
-    
-    // Wait for tooltip to appear
-    await new Promise(r => setTimeout(r, 1000));
-    
-    // Verify tooltip is visible
-    await testdriver.assert('tooltip is displayed');
-    
-    // Extract tooltip text
-    const tooltipText = await testdriver.extract('the tooltip message');
-    console.log('Tooltip says:', tooltipText);
-  });
+describe('Hover', () => {
+  it('highlights the sign in button on hover', async (context) => {
+    const testdriver = TestDriver(context);
+    await testdriver.provision.chrome({ url: 'https://testdriver-sandbox.vercel.app/login' });
 
-  it('should navigate dropdown menu', async () => {
-    // Hover over main menu
-    const menu = await testdriver.find('Navigation menu');
-    await menu.hover();
-    
-    // Wait for dropdown
-    await new Promise(r => setTimeout(r, 500));
-    
-    // Hover over submenu item
-    const submenu = await testdriver.find('Account submenu');
-    await submenu.hover();
-    
-    await new Promise(r => setTimeout(r, 300));
-    
-    // Click nested menu item
-    const settings = await testdriver.find('Settings option');
-    await settings.click();
-    
-    await testdriver.assert('settings page is displayed');
-  });
+    await testdriver.find('Sign in button below the password field').hover();
 
-  it('should preview images on hover', async () => {
-    // Hover over product image
-    const productImg = await testdriver.find('product 1 thumbnail');
-    await productImg.hover();
-    
-    // Wait for preview
-    await new Promise(r => setTimeout(r, 800));
-    
-    // Verify preview appeared
-    await testdriver.assert('large product preview is shown');
-    
-    // Move away
-    const otherElement = await testdriver.find('page heading');
-    await otherElement.hover();
-    
-    // Verify preview disappeared
-    await new Promise(r => setTimeout(r, 500));
-    await testdriver.assert('product preview is hidden');
+    const result = await testdriver.assert('the mouse pointer is over the Sign in button');
+    expect(result).toBe(true);
   });
 });
 ```
 
-## Related Methods
+## Related
 
-- [`find()`](/find) - Locate elements to hover
-- [`click()`](/click) - Click after hovering
-- [`mouseDown()`](/click) - Start drag operations
+- [find()](/find): locate the element to hover over
+- [click()](/click): click after a menu opens
+- [mouseDown()](/mouse-down) and [mouseUp()](/mouse-up): drag and drop
+- [Perform actions](/performing-actions): every kind of action in one guide