testdriverai 6.0.22 → 6.0.23

package/docs/images/content/extension/vscode.svg

@@ -0,0 +1,57 @@
+<svg width="100" height="100" viewBox="0 0 100 100" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0)">
+<g filter="url(#filter0_d)">
+<mask id="mask0" mask-type="alpha" maskUnits="userSpaceOnUse" x="0" y="0" width="100" height="100">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M70.9119 99.5723C72.4869 100.189 74.2828 100.15 75.8725 99.3807L96.4604 89.4231C98.624 88.3771 100 86.1762 100 83.7616V16.2392C100 13.8247 98.624 11.6238 96.4604 10.5774L75.8725 0.619067C73.7862 -0.389991 71.3446 -0.142885 69.5135 1.19527C69.252 1.38636 69.0028 1.59985 68.769 1.83502L29.3551 37.9795L12.1872 24.88C10.5891 23.6607 8.35365 23.7606 6.86938 25.1178L1.36302 30.1525C-0.452603 31.8127 -0.454583 34.6837 1.35854 36.3466L16.2471 50.0001L1.35854 63.6536C-0.454583 65.3164 -0.452603 68.1876 1.36302 69.8477L6.86938 74.8824C8.35365 76.2395 10.5891 76.34 12.1872 75.1201L29.3551 62.0207L68.769 98.1651C69.3925 98.7923 70.1246 99.2645 70.9119 99.5723ZM75.0152 27.1813L45.1092 50.0001L75.0152 72.8189V27.1813Z" fill="white"/>
+</mask>
+<g mask="url(#mask0)">
+<path d="M96.4614 10.593L75.8567 0.62085C73.4717 -0.533437 70.6215 -0.0465506 68.7498 1.83492L1.29834 63.6535C-0.515935 65.3164 -0.513852 68.1875 1.30281 69.8476L6.8125 74.8823C8.29771 76.2395 10.5345 76.339 12.1335 75.1201L93.3604 13.18C96.0854 11.102 100 13.0557 100 16.4939V16.2535C100 13.84 98.6239 11.64 96.4614 10.593Z" fill="#D9D9D9"/>
+<g filter="url(#filter1_d)">
+<path d="M96.4614 89.4074L75.8567 99.3797C73.4717 100.534 70.6215 100.047 68.7498 98.1651L1.29834 36.3464C-0.515935 34.6837 -0.513852 31.8125 1.30281 30.1524L6.8125 25.1177C8.29771 23.7605 10.5345 23.6606 12.1335 24.88L93.3604 86.8201C96.0854 88.8985 100 86.9447 100 83.5061V83.747C100 86.1604 98.6239 88.3603 96.4614 89.4074Z" fill="#E6E6E6"/>
+</g>
+<g filter="url(#filter2_d)">
+<path d="M75.8578 99.3807C73.4721 100.535 70.6219 100.047 68.75 98.1651C71.0564 100.483 75 98.8415 75 95.5631V4.43709C75 1.15852 71.0565 -0.483493 68.75 1.83492C70.6219 -0.0467614 73.4721 -0.534276 75.8578 0.618963L96.4583 10.5773C98.6229 11.6237 100 13.8246 100 16.2391V83.7616C100 86.1762 98.6229 88.3761 96.4583 89.4231L75.8578 99.3807Z" fill="white"/>
+</g>
+<g style="mix-blend-mode:overlay" opacity="0.25">
+<path style="mix-blend-mode:overlay" opacity="0.25" fill-rule="evenodd" clip-rule="evenodd" d="M70.8508 99.5723C72.4258 100.189 74.2218 100.15 75.8115 99.3807L96.4 89.4231C98.5635 88.3771 99.9386 86.1762 99.9386 83.7616V16.2391C99.9386 13.8247 98.5635 11.6239 96.4 10.5774L75.8115 0.618974C73.7252 -0.390085 71.2835 -0.142871 69.4525 1.19518C69.1909 1.38637 68.9418 1.59976 68.7079 1.83493L29.2941 37.9795L12.1261 24.88C10.528 23.6606 8.2926 23.7605 6.80833 25.1177L1.30198 30.1524C-0.51354 31.8126 -0.515625 34.6837 1.2975 36.3465L16.186 50L1.2975 63.6536C-0.515625 65.3164 -0.51354 68.1875 1.30198 69.8476L6.80833 74.8824C8.2926 76.2395 10.528 76.339 12.1261 75.1201L29.2941 62.0207L68.7079 98.1651C69.3315 98.7923 70.0635 99.2645 70.8508 99.5723ZM74.9542 27.1812L45.0481 50L74.9542 72.8188V27.1812Z" fill="url(#paint0_linear)"/>
+</g>
+</g>
+</g>
+</g>
+<defs>
+<filter id="filter0_d" x="-6.25" y="-4.16667" width="112.5" height="112.5" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feColorMatrix in="SourceAlpha" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"/>
+<feOffset dy="2.08333"/>
+<feGaussianBlur stdDeviation="3.125"/>
+<feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.15 0"/>
+<feBlend mode="normal" in2="BackgroundImageFix" result="effect1_dropShadow"/>
+<feBlend mode="normal" in="SourceGraphic" in2="effect1_dropShadow" result="shape"/>
+</filter>
+<filter id="filter1_d" x="-8.39436" y="15.6951" width="116.728" height="92.6376" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feColorMatrix in="SourceAlpha" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"/>
+<feOffset/>
+<feGaussianBlur stdDeviation="4.16667"/>
+<feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.25 0"/>
+<feBlend mode="overlay" in2="BackgroundImageFix" result="effect1_dropShadow"/>
+<feBlend mode="normal" in="SourceGraphic" in2="effect1_dropShadow" result="shape"/>
+</filter>
+<filter id="filter2_d" x="60.4167" y="-8.33346" width="47.9167" height="116.667" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feColorMatrix in="SourceAlpha" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"/>
+<feOffset/>
+<feGaussianBlur stdDeviation="4.16667"/>
+<feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.25 0"/>
+<feBlend mode="overlay" in2="BackgroundImageFix" result="effect1_dropShadow"/>
+<feBlend mode="normal" in="SourceGraphic" in2="effect1_dropShadow" result="shape"/>
+</filter>
+<linearGradient id="paint0_linear" x1="49.939" y1="-5.19792e-05" x2="49.939" y2="100.001" gradientUnits="userSpaceOnUse">
+<stop stop-color="white"/>
+<stop offset="1" stop-color="white" stop-opacity="0"/>
+</linearGradient>
+<clipPath id="clip0">
+<rect width="100" height="100" fill="white"/>
+</clipPath>
+</defs>
+</svg>

package/docs/images/content/extension/windsurf.svg

@@ -0,0 +1,3 @@
+<svg width="1024" height="1024" viewBox="0 0 1024 1024" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M897.246 286.869H889.819C850.735 286.808 819.017 318.46 819.017 357.539V515.589C819.017 547.15 792.93 572.716 761.882 572.716C743.436 572.716 725.02 563.433 714.093 547.85L552.673 317.304C539.28 298.16 517.486 286.747 493.895 286.747C457.094 286.747 423.976 318.034 423.976 356.657V515.619C423.976 547.181 398.103 572.746 366.842 572.746C348.335 572.746 329.949 563.463 319.021 547.881L138.395 289.882C134.316 284.038 125.154 286.93 125.154 294.052V431.892C125.154 438.862 127.285 445.619 131.272 451.34L309.037 705.2C319.539 720.204 335.033 731.344 352.9 735.392C397.616 745.557 438.77 711.135 438.77 667.278V508.406C438.77 476.845 464.339 451.279 495.904 451.279H495.995C515.02 451.279 532.857 460.562 543.785 476.145L705.235 706.661C718.659 725.835 739.327 737.218 763.983 737.218C801.606 737.218 833.841 705.9 833.841 667.308V508.376C833.841 476.815 859.41 451.249 890.975 451.249H897.276C901.233 451.249 904.43 448.053 904.43 444.097V294.021C904.43 290.065 901.233 286.869 897.276 286.869H897.246Z" fill="white"/>
+</svg>

package/docs/overview/performance.mdx

@@ -3,6 +3,7 @@ title: "Performance"
 sidebarTitle: "Performance"
 description: "Expected Command Performance"
 icon: "rabbit-running"
+mode: "wide"
 ---
 
 This guide outlines the typical performance characteristics of each TestDriver command based on observed average execution times. These measurements can help guide optimization, identify bottlenecks, and set realistic expectations when designing automated tests.

package/docs/overview/quickstart.mdx

@@ -3,108 +3,83 @@ title: "Quickstart"
 sidebarTitle: "Quickstart"
 description: "Get started with TestDriver in minutes."
 icon: "gauge-high"
+mode: "wide"
 ---
 
-import Comments from "/snippets/comments.mdx";
-
-TestDriver isn't just a computer-use agent, it's an entire AI-native workflow for creating end-to-end tests. Follow these steps to set up your environment and get started with TestDriver.
+<Tip>
+  You will need a [TestDriver Pro](https://app.testdriver.ai/team) account
+  ($20/m) to complete setup.
+</Tip>
 
 <Steps>
-  <Step title="Create a TestDriver Account">
-    Because TestDriver is powered by agentic users, a **free** account is required to access:
+  <Step title="Install TestDriver">
 
-    - Dedicated Virtual Machines (VMs) for running agents
-    - TestDriver AI \+ Vision models
-    - Community support
+    Click the button below to install the TestDriver extension for your preferred IDE. Then, follow the setup guide and chat with TestDriver to create your first test.
 
-    <Card title="Sign Up Now" icon="arrow-turn-down-right" iconType="duotone" horizontal href="https://app.testdriver.ai">
-      No Credit-Card Required
-    </Card>
+    <Card
+      horizontal
+      title="VS Code"
+      arrow
+      href="vscode:extension/testdriver.testdriver"
+      icon="/images/content/extension/vscode.svg"
+    ></Card>
 
-  </Step>
-  <Step title="Set up your environment">
-      
-    Copy your API key from [the TestDriver dashboard](https://app.testdriver.ai/team), and set it as an environment variable.
-    
-    <Tabs>
-      <Tab title="macOS / Linux">
-        ```bash Export an environment variable on macOS or Linux systems
-        export TD_API_KEY="your_api_key_here"
-        ```
-      </Tab>
-      <Tab title="Windows">
-      ```powershell Export an environment variable in PowerShell
-      setx TD_API_KEY "your_api_key_here"
-      ```
-      </Tab>
-    </Tabs>
+    <Card
+      horizontal
+      title="Cursor"
+      arrow
+    href="cursor:extension/testdriver.testdriver"
+    icon="/images/content/extension/cursor.svg"
 
-  </Step>
-  <Step title="Try an example test">
-      
-    Download the TestDriver GitHub repository and run the web example test.
+    > </Card>
 
-    ```bash
-    git clone https://github.com/testdriverai/cli testdriverai
-    cd testdriverai/testdriver/examples/web
-    ```
+    <Card
+      horizontal
+      title="Windsurf"
+      arrow
+      href="windsurf:extension/testdriver.testdriver"
+      icon="/images/content/extension/windsurf.svg"
+    ></Card>
 
-    TestDriver tests are written in YAML, a human-readable data format. The `example.yaml` file contains a series of steps that the agent will execute.
-
-    ```yaml testdriver/test.yaml
-    steps:
-      - prompt: log in
-      - prompt: add an item to the cart
-      - prompt: click on the cart icon
-      - prompt: complete checkout
-    ```
-
-    Each step has a `prompt` that describes what the agent should do. The agent will use the prompt to generate [commands](/commands) that make the tests faster and more reliable the next time you run the test.
+    The extension will generate most of your tests for you, but you'll probably want to customize them. [Learn more about editing tests](/getting-started/editing).
 
   </Step>
-  <Step title="Generate test steps from prompts">
+  <Step title="Run your tests in CI/CD">
     
-    Run the following command to run the test file. TestDriver will spawn a virtual machine, launch the sandbox test page, and execute the steps defined in the `example.yaml` file.
+    Next, use `testdriverai` to run your tests in CI/CD pipelines.
 
     ```bash
-    npx testdriverai@beta run example.yaml --write --heal
+    TD_API_KEY=YOUR_KEY npx testdriverai@latest run testdriver/test.yaml
     ```
 
-    The `--write` flag tells TestDriver to save any generated commands to the test file, and the `--heal` flag allows TestDriver to recover from unexpected issues during the test run.
+    Note that you'll want to store your API key within secret storeage. [Learn more about running tests in CI/CD pipelines](/action/setup).
 
   </Step>
-  <Step title="Run a regression test">
-
-    ```yaml
-      version: 5.7.7
-      session: 682f6071811bd5a322c0e6dd
-      steps:
-        - prompt: focus chrome
-          commands:
-            - command: focus-application
-              name: Google Chrome
-        - prompt: enter a username
-          commands:
-            - command: hover-text
-              text: Username
-              description: username input field
-              action: click
-            - command: type
-              text: standard_user
-        - prompt: enter a password
-          commands:
-            - command: hover-text
-              text: Password
-              description: password input field
-              action: click
-            - command: type
-              text: secret_password
-      ```
-
-      The `--write` command tells the agent to save the generated commands to the test file, and the `--heal` command gives the agent permission to recover if something goes wrong.
 
-  </Step>
-</Steps>
+  <Step title="Managing your test suite">
+
+    There's so much more you can do with TestDriver! Here are some popular features to explore:
+
+    <Columns cols={2}>
+      <Card title="Importing Tests" icon="table" href="/importing/csv">
+        Generate tests from other formats like CSV, Gherkin, etc.
+      </Card>
+      <Card title="Self Healing" icon="bandage" href="/features/auto-healing">
+        Automatically update tests when the application changes.
+      </Card>
+      <Card title="Variable Test Data" icon="square-root-variable" href="/guide/variables">
+        Use variables run the same test with different data sets.
+      </Card>
+      <Card title="Reusable Snippets" icon="repeat" href="/features/reusable-snippets">
+        Embed reusable snippets to simplify your test scripts.
+      </Card>
+      <Card title="Running Custom Code" icon="code" href="/guide/code">
+        Use custom powershell or NodeJS code to extend the capabilities of your tests.
+      </Card>
+      <Card title="Setup & Teardown" icon="wrench" href="/guide/lifecycle">
+        Systemically prepare the sandbox before running tests and clean up afterward.
+      </Card>
+    </Columns>
 
-<Comments />
-```
+  </Step>
+  </Steps>

package/docs/overview/what-is-testdriver.mdx

@@ -1,21 +1,21 @@
 ---
-title: "What's TestDriver?"
-sidebarTitle: "What's TestDriver?"
+title: "What Is TestDriver?"
+sidebarTitle: "What Is TestDriver?"
 description: "TestDriver is a computer-use agent for QA testing of user interfaces."
 icon: "circle-info"
 ---
 
-TestDriver uses AI vision and keyboard and mouse control to automate end-to-end testing. TestDriver is `selectorless` meaning it isn't aware of the underlying code structure.
+TestDriver uses AI vision and keyboard and mouse control to automate end-to-end testing. TestDriver is `selectorless`, meaning it doesn't rely on CSS selectors or static analysis to find elements.
 
 <CardGroup cols={3}>
-  <Card title="Easier Setup" icon="wrench">
-    No need to craft complex selectors.
+  <Card title="Cross-Platform" icon="bolt">
+    Test web, mobile, desktop and more with a single tool.
   </Card>
-  <Card title="More Power" icon="bolt">
-    TestDriver can test anything a user can do.
+  <Card title="Easy Setup" icon="wrench">
+    No need to craft or maintain complex selectors.
   </Card>
   <Card title="Less Maintenance" icon="bandage">
-    Tests don't break when code changes.
+    Tests won't break when code changes.
   </Card>
 </CardGroup>
 

package/docs/styles.css

@@ -4,3 +4,7 @@
   padding-bottom: 0 !important;
   text-decoration: none !important;
 }
+
+.card img {
+  background-color: transparent !important;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "testdriverai",
-  "version": "6.0.22",
+  "version": "6.0.23",
   "description": "Next generation autonomous AI agent for end-to-end testing of web & desktop",
   "main": "index.js",
   "bin": {

package/docs/getting-started/setup.mdx

@@ -1,125 +0,0 @@
----
-title: "Setting up TestDriver CLI"
-sidebarTitle: "CLI Setup"
-description: "Follow these steps to install and set up TestDriver CLI."
-icon: "square-terminal"
----
-
-<Steps>
-  <Step title="Install Node.js">
-    Ensure you have Node.js (v16 or higher) installed.
-
-    Check your Node.js version:
-
-    ```bash
-    node -v
-    ```
-
-    If not installed, download it from [Node.js Official Website](https://nodejs.org/).
-
-  </Step>
-  <Step title="Install NPM">
-    **npm**: Comes with Node.js. Verify `npm` is installed:
-
-    ```bash
-    npm -v
-    ```
-
-  </Step>
-  <Step title="Set Up Your Test Runner" stepNumber={3}>
-    In your project directory, run the interactive setup process:
-
-    ```sh
-    npx testdriverai@latest init
-    ```
-
-    TestDriver requires a runner to execute tests. You can use either a hosted sandbox or your own computer.
-
-    - **TestDriver Sandbox** - Run tests in a ephemeral linux virtual machine. Recommended for ease of use, added privacy, and parallelization. Requires a TestDriver API key.
-    - **Local Runner** - Run tests on your own computer. Recommended for working with existing user sessions, files, and applications. Requires additional setup.
-
-    <Tabs>
-      <Tab title="Hosted Sandbox Setup">
-        Running `init` in your project directory and choose "yes" for the sandbox option. This will prompt you for your API key.
-
-        ```
-        Beginning setup...
-        ✔ Use TestDriver Sandbox Runners? (Recommended) … yes
-        ? API KEY (from https://app.testdriver.ai/team) › ********
-        ```
-
-        This will write the `TD_API_KEY` values to `.env` file in your project directory.
-      </Tab>
-      <Tab title="Local Windows Setup">
-        #### Install Python & Visual Studio build tools
-
-        ```powershell
-        choco install python visualstudio2022-workload-vctools -y
-        ```
-
-        #### Install Node.js
-
-        You will also need Node.js if you don't have it yet.
-
-        ```powershell
-        choco install nodejs-lts --version="20.17.0"
-        ```
-
-        #### Set execution policy
-
-        Open a new terminal with admin privileges and execute the following command :
-
-        ```powershell
-        Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
-        ```
-
-        This gives TestDriver the right to execute it's scripts and is only valid for the current user.
-      </Tab>
-      <Tab title="Local Mac Setup">
-        #### Enable screen recording permissions
-
-        TestDriver requires screen recording permissions to capture your screen during test execution.
-
-        - Open **System Preferences \> Security & Privacy \> Privacy \> Screen Recording**.
-        - Check the box next to your terminal application (for example, Terminal, iTerm2) to allow screen recording.
-
-        This is required for TestDriver to capture your screen during test execution.
-
-        #### Enable accessibility permissions
-
-        - Open **System Preferences \> Security & Privacy \> Privacy \> Accessibility**.
-        - Check the box next to your terminal application (for example, Terminal, iTerm2) to allow accessibility features.
-
-        This is required for TestDriver to interact with your applications during test execution.
-      </Tab>
-    </Tabs>
-
-  </Step>
-  <Step title="Run TestDriver in Interactive Mode" stepNumber={4}>
-    Start TestDriver in interactive mode.
-
-    ```bash
-    npx testdriverai@latest
-    ```
-
-    You should see a prompt like this:
-
-    ```bash
-    Howdy! I'm TestDriver v4.2.26
-    ```
-
-  </Step>
-</Steps>
-
-<CardGroup cols={2}>
-  <Card
-    title="Self-Driving Tests"
-    icon="link"
-    href="/getting-started/generating"
-  >
-    TestDriver will come up with it's own ideas for testing.
-  </Card>
-  <Card title="Test Copilot" icon="link" href="/getting-started/writing">
-    Write custom tests
-  </Card>
-</CardGroup>