@testdriverai/mcp 7.11.264-canary → 7.11.265-test

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

@@ -1,293 +0,0 @@
----
-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

@@ -1,25 +0,0 @@
----
-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'
-```

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

@@ -1,155 +0,0 @@
----
-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 per user**
-    
-    - 2 Concurrent Sandboxes
-    - 120 Minutes Included
-    - Overage: $0.001/second
-    - 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>