@testdriverai/agent 7.9.33-test → 7.9.34-test

package/ai/skills/testdriver:focus-application/SKILL.md

@@ -0,0 +1,293 @@
+---
+name: testdriver:focus-application
+description: Bring an application window to the foreground
+---
+<!-- Generated from focus-application.mdx. DO NOT EDIT. -->
+
+## Overview
+
+Bring a specific application window to the foreground and make it the active window for interactions.
+
+## Syntax
+
+```javascript
+await testdriver.focusApplication(name)
+```
+
+## Parameters
+
+<ParamField path="name" type="string" required>
+  Application name (e.g., `'Google Chrome'`, `'Microsoft Edge'`, `'Notepad'`)
+</ParamField>
+
+## Returns
+
+`Promise<string>` - Result message
+
+## Examples
+
+### Common Applications
+
+```javascript
+// Focus Chrome browser
+await testdriver.focusApplication('Google Chrome');
+
+// Focus Edge browser
+await testdriver.focusApplication('Microsoft Edge');
+
+// Focus Notepad
+await testdriver.focusApplication('Notepad');
+
+// Focus File Explorer
+await testdriver.focusApplication('File Explorer');
+
+// Focus Visual Studio Code
+await testdriver.focusApplication('Visual Studio Code');
+```
+
+### After Opening Applications
+
+```javascript
+// Open Chrome and focus it
+await testdriver.exec('pwsh', `
+  Start-Process "C:/Program Files/Google/Chrome/Application/chrome.exe" -ArgumentList "https://example.com"
+`, 5000);
+
+await new Promise(r => setTimeout(r, 2000)); // Wait for launch
+
+// Focus the Chrome window
+await testdriver.focusApplication('Google Chrome');
+```
+
+## Best Practices
+
+<Check>
+  **Focus before UI interactions**
+  
+  Always focus the target application before interacting with its UI:
+  
+  ```javascript
+  await testdriver.focusApplication('Google Chrome');
+  
+  const button = await testdriver.find('submit button');
+  await button.click();
+  ```
+</Check>
+
+<Check>
+  **Wait after launching apps**
+  
+  Give applications time to open before focusing:
+  
+  ```javascript
+  await testdriver.exec('pwsh', 'Start-Process notepad', 5000);
+  await new Promise(r => setTimeout(r, 1000)); // Wait for launch
+  await testdriver.focusApplication('Notepad');
+  ```
+</Check>
+
+<Check>
+  **Use exact application names**
+  
+  ```javascript
+  // ✅ Correct
+  await testdriver.focusApplication('Google Chrome');
+  
+  // ❌ May not work
+  await testdriver.focusApplication('Chrome');
+  await testdriver.focusApplication('chrome.exe');
+  ```
+</Check>
+
+<Warning>
+  **Application must be running**
+  
+  The application must already be running. `focusApplication()` won't launch applications, only bring existing windows to the foreground.
+</Warning>
+
+## Use Cases
+
+<AccordionGroup>
+  <Accordion title="Multi-Application Testing">
+    ```javascript
+    // Test workflow across multiple apps
+    await testdriver.focusApplication('Google Chrome');
+    const data = await testdriver.extract('the order number');
+    
+    await testdriver.focusApplication('Notepad');
+    await testdriver.type(data);
+    await testdriver.pressKeys(['ctrl', 's']);
+    
+    await testdriver.focusApplication('Google Chrome');
+    const nextButton = await testdriver.find('next button');
+    await nextButton.click();
+    ```
+  </Accordion>
+  
+  <Accordion title="Browser Switching">
+    ```javascript
+    // Compare behavior in different browsers
+    await testdriver.focusApplication('Google Chrome');
+    await testdriver.assert('page loaded correctly in Chrome');
+    
+    await testdriver.focusApplication('Microsoft Edge');
+    await testdriver.assert('page loaded correctly in Edge');
+    ```
+  </Accordion>
+  
+  <Accordion title="Desktop Application Testing">
+    ```javascript
+    // Launch and focus desktop app
+    await testdriver.exec('pwsh', 'Start-Process notepad', 5000);
+    await new Promise(r => setTimeout(r, 1000));
+    
+    await testdriver.focusApplication('Notepad');
+    await testdriver.type('Test content');
+    ```
+  </Accordion>
+  
+  <Accordion title="Window Management">
+    ```javascript
+    // Show desktop first
+    await testdriver.pressKeys(['winleft', 'd']);
+    
+    // Click desktop icon
+    const icon = await testdriver.find('Chrome icon on desktop');
+    await icon.click();
+    
+    await new Promise(r => setTimeout(r, 2000));
+    
+    // Focus the opened window
+    await testdriver.focusApplication('Google Chrome');
+    ```
+  </Accordion>
+</AccordionGroup>
+
+## Common Application Names
+
+### Browsers
+- `'Google Chrome'`
+- `'Microsoft Edge'`
+- `'Mozilla Firefox'`
+- `'Safari'` (macOS)
+
+### Office Applications
+- `'Microsoft Word'`
+- `'Microsoft Excel'`
+- `'Microsoft PowerPoint'`
+- `'Microsoft Outlook'`
+
+### Development Tools
+- `'Visual Studio Code'`
+- `'Visual Studio'`
+- `'IntelliJ IDEA'`
+- `'Sublime Text'`
+
+### System Applications
+- `'Notepad'`
+- `'File Explorer'`
+- `'Command Prompt'`
+- `'Windows PowerShell'`
+- `'Task Manager'`
+
+### Communication
+- `'Microsoft Teams'`
+- `'Slack'`
+- `'Discord'`
+- `'Zoom'`
+
+## Complete Example
+
+```javascript
+import { beforeAll, afterAll, describe, it } from 'vitest';
+import TestDriver from 'testdriverai';
+
+describe('Multi-Application Workflow', () => {
+  let testdriver;
+
+  beforeAll(async () => {
+    client = new TestDriver(process.env.TD_API_KEY);
+    await testdriver.auth();
+    await testdriver.connect();
+  });
+
+  afterAll(async () => {
+    await testdriver.disconnect();
+  });
+
+  it('should work across multiple applications', async () => {
+    // Start in browser
+    await testdriver.focusApplication('Google Chrome');
+    
+    // Get data from web page
+    const orderNumber = await testdriver.extract('the order number');
+    console.log('Order:', orderNumber);
+    
+    // Open Notepad
+    await testdriver.exec('pwsh', 'Start-Process notepad', 5000);
+    await new Promise(r => setTimeout(r, 1500));
+    
+    // Focus Notepad and save data
+    await testdriver.focusApplication('Notepad');
+    await testdriver.type(`Order Number: ${orderNumber}`);
+    await testdriver.type('\n');
+    await testdriver.type(`Date: ${new Date().toISOString()}`);
+    
+    // Save file
+    await testdriver.pressKeys(['ctrl', 's']);
+    await new Promise(r => setTimeout(r, 500));
+    
+    await testdriver.type('C:\\order-info.txt');
+    await testdriver.pressKeys(['enter']);
+    
+    // Return to browser
+    await testdriver.focusApplication('Google Chrome');
+    
+    const confirmButton = await testdriver.find('confirm order button');
+    await confirmButton.click();
+    
+    await testdriver.assert('order confirmed');
+  });
+
+  it('should switch between browser tabs', async () => {
+    await testdriver.focusApplication('Google Chrome');
+    
+    // Open new tab
+    await testdriver.pressKeys(['ctrl', 't']);
+    await new Promise(r => setTimeout(r, 500));
+    
+    // Navigate to URL
+    await testdriver.pressKeys(['ctrl', 'l']);
+    await testdriver.type('https://example.com');
+    await testdriver.pressKeys(['enter']);
+    
+    await new Promise(r => setTimeout(r, 2000));
+    
+    // Ensure Chrome is still focused
+    await testdriver.focusApplication('Google Chrome');
+    
+    await testdriver.assert('example.com page is loaded');
+  });
+
+  it('should handle dialog boxes', async () => {
+    await testdriver.focusApplication('Google Chrome');
+    
+    const deleteButton = await testdriver.find('delete account button');
+    await deleteButton.click();
+    
+    await new Promise(r => setTimeout(r, 500));
+    
+    // Dialog appears - make sure it's focused
+    await testdriver.focusApplication('Google Chrome');
+    
+    const confirmBtn = await testdriver.find('confirm deletion button');
+    await confirmBtn.click();
+  });
+});
+```
+
+## Related Methods
+
+- [`exec()`](/v7/exec) - Launch applications with PowerShell
+- [`pressKeys()`](/v7/press-keys) - Use Alt+Tab to switch windows
+- [`find()`](/v7/find) - Locate elements in the focused window

package/ai/skills/testdriver:generating-tests/SKILL.md

@@ -0,0 +1,36 @@
+---
+name: testdriver:generating-tests
+description: Use AI coding agents and exploration mode to generate TestDriver tests
+---
+<!-- Generated from generating-tests.mdx. DO NOT EDIT. -->
+
+## Instructions for Coding Agents
+
+We recommend starting with [our quickstart](./quickstart) then supplying your coding agent with our agent instructions file.
+
+<Card title="TestDriver Agent Instructions" icon="link" arrow="true" horizontal href="https://github.com/testdriverai/testdriverai/blob/main/ai/agents/testdriver.md?plain=1">
+  Copy the current version of our agent instructions to provide your coding agent with up-to-date instructions on how to generate TestDriver tests.
+</Card>
+
+Then, you can prompt your coding agent to generate tests. Here is an example prompt:
+
+```md
+Make me a TestDriver test that does the following steps:
+
+Navigate to practicetestautomation.com
+Type username student into Username field
+Type password Password123 into Password field
+Push Submit button
+Verify new page contains expected text 'logged in'
+```
+
+## AI Exploration Mode
+
+Within a test, the `ai()` method lets TestDriver autonomously figure out how to accomplish a task. It's useful for dynamic or unpredictable UIs where explicit actions may be difficult to define.
+
+```javascript
+// Handle dynamic or unpredictable UI
+await testdriver.ai('dismiss any popups or modals that appear');
+```
+
+<Info>Explicit commands are preferred for production tests, as they are cheaper, faster, and more reliable.</Info>

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

@@ -0,0 +1,156 @@
+---
+name: testdriver:hosted
+description: The fastest way to get started with TestDriver. Just set your API key and start testing.
+---
+<!-- Generated from hosted.mdx. DO NOT EDIT. -->
+
+Hosted pricing is based on **device-seconds**: the amount of time your tests run on **our infrastructure**.
+
+- **Zero Setup** — Start testing immediately. No DevOps required.
+- **Free Tier** — Get started with a limited preview at no cost.
+- **Pay As You Go** — Only pay for the device-seconds you use.
+
+## Hosted Plans
+
+<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
+  </Card>
+  
+  <Card title="Pro" icon="rocket" href="https://console.testdriver.ai/checkout/pro">
+    **$20/month**
+    
+    - 2 Concurrent Sandboxes
+    - 600 Minutes Included
+    - Overage: $0.002/second
+    - 1 Team User
+    - Test Recordings
+    - Community Support
+  </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>
+</CardGroup>
+
+## Get Started
+Hosted is the default when you follow the Quickstart guide. 
+<Card
+  title="Try the Quickstart"  
+  icon="play"
+  href="/v7/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](/v7/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="/v7/self-hosted"
+>
+  Learn about self-hosting for unlimited test execution at a flat rate.
+</Card>