Testdriver Changelog

---
name: testdriver:changelog
description: Product updates and announcements
---
<!-- Generated from changelog.mdx. DO NOT EDIT. -->

<Update label="v7.9.51-canary" description="April 2026" tags={["canary"]}>

🚀 Canary release

This release promotes changes from `v7.9.4-test` through `v7.9.51-test` to canary, rolling up all updates since `v7.9.3`.

✨ New features

- (Internal) **Autoscaling**
- (Internal) **End-to-end distributed tracing**

🔧 Improvements

- **Faster image matching**
- **Storage and infra hardening**
- **Sentry environment consistency**
- **Chrome extension interaction reliability**
- **Docs and onboarding refresh** — Updated v7 docs, SDK examples, and VS Code onboarding/init flows.

🐛 Bug fixes

- **Windows AMI build stability** — Fixed `chrome.exe` startup/build failures.
- **Realtime cleanup reliability** — Fixed connection cleanup leaks in session shutdown paths.
- **Environment and deployment fixes** 

</Update>

<Update label="v7.8.0-test.22" description="March 2026" tags={["test"]}>

Releases test.11 through test.22 include version bumps and internal CI improvements across all packages. No new user-facing changes — see [v7.8.0-test.10](#v780-test10) for the latest updates in this release stream.

</Update>

<Update label="v7.8.0-test.10" description="March 2026" tags={["test"]}>

🔧 Improvements

- **Parallel test concurrency** — Concurrency limits are now enforced with atomic slot tracking, eliminating a race condition where multiple tests launching at the same time could all bypass the limit. If you hit your concurrency cap, the SDK waits and retries automatically.
- **Dashboard access for all plans** — Test recordings and metrics on the [dashboard](https://console.testdriver.ai) are now visible to all users, including those on the Free plan.
- **Sandbox message throttling** — High-frequency interactions no longer risk hitting connection limits. The SDK automatically paces outgoing messages during fast command sequences.
- **Windows Dashcam stability** — Web log tracking on Windows sandboxes now handles errors gracefully instead of failing the test.

</Update>

<Update label="v7.8.0-test.9" description="March 2026" tags={["test"]}>

🔧 Improvements

- **Stable release promotion** — Fixed an issue where promoting a test or canary release to stable could be incorrectly skipped. Stable releases now proceed reliably regardless of the prior pre-release channel.
- **Example docs sync** — Example documentation now updates more reliably, continuing even when individual example tests fail so that passing examples still get refreshed.

</Update>

<Update label="v7.8.0-test.8" description="March 2026" tags={["test"]}>

🔧 Improvements

- **VS Code environment switching** — The TestDriver VS Code extension now includes a status bar indicator and a new **TestDriver: Switch Environment** command. You can switch between stable, canary, and test environments directly from VS Code, and your MCP server configuration updates automatically.
- **Plan rename: Starter → Pro** — The "Starter" plan has been renamed to **Pro**. No changes to pricing or features — just a clearer name. The "Self-Hosted" tier is now labeled **Enterprise**.
- **SDK network resilience** — API requests now automatically retry on transient server errors (500, 502, 503, 504) with exponential backoff, reducing flaky test failures caused by brief infrastructure hiccups.
- **Pricing page refresh** — The [hosted plans page](/hosted) now shows plan cards with included minutes, concurrency limits, and pricing at a glance.

📚 Docs updates

- **Quickstart redesign** — The [quickstart](/quickstart) now has tabbed setup paths for CLI, GitHub Copilot, and manual installation.
- **Deployment section** — "Cloud" is now [Hosted](/hosted) and the previous Enterprise page has been consolidated into [Self-Hosted](/self-hosted), which covers both standard and air-gapped deployments.

</Update>

<Update label="v7.8.0-test.7" description="March 2026" tags={["test"]}>
This release includes all changes from v7.8.0-test.6 with version bumps across all packages. No additional user-facing changes.
</Update>

<Update label="v7.8.0-test.6" description="March 2026" tags={["test"]}>

🔧 Improvements

- **Sandbox spawning reliability** — Sandbox creation now uses a 3-minute timeout to handle slow infrastructure, then immediately switches to a 60-second orphan timeout for fast cleanup. This reduces sandbox creation failures during high-traffic periods.
- **Command deadline timeouts** — Sandbox commands now enforce a hard deadline that terminates execution if the connection drops mid-command, preventing tests from hanging indefinitely.
- **Real-time channel cleanup** — Fixed a compatibility issue with the real-time messaging layer that could cause channel cleanup to fail during shutdown.
- **Dashboard timestamp tooltips** — Extended UTC date tooltips to the test history sidebar. Hovering over any relative timestamp (e.g., "5 minutes ago") across the [dashboard](https://console.testdriver.ai) now shows the full UTC date and time.

</Update>

<Update label="v7.8.0-test.4" description="March 2026" tags={["test"]}>

✨ New features

- **[GitHub Copilot integration](/copilot/running-tests)** — Use TestDriver directly from GitHub Copilot in VS Code. The new MCP server lets Copilot launch sandboxes, interact with elements, and run assertions through natural language. Includes guides for [creating tests](/generating-tests), [running tests](/copilot/running-tests), [GitHub Actions integration](/copilot/auto-healing#use-testdriver-in-github), and [auto-healing](/copilot/auto-healing).

🔧 Improvements

- **Sandbox reliability** — Linux sandboxes now use a longer creation timeout to handle slow infrastructure, then immediately switch to a short orphan timeout for fast cleanup of disconnected sessions.
- **Command execution timeouts** — Sandbox commands now have deadline timeouts that prevent hangs if the connection drops mid-execution.
- **Real-time connection stability** — Updated the real-time messaging layer for better compatibility and more reliable channel cleanup during shutdown.
- **Dashboard date display** — Hovering over relative timestamps (e.g., "5 minutes ago") now shows the full UTC date and time.

</Update>

<Update label="v7.8.0-canary.5" description="March 2026" tags={["canary"]}>
This release includes all changes from v7.8.0-canary.4 with version bumps.

✨ New features

- **[Cache API](/cache)** — Speed up repeated test runs with screenshot-based caching. The system compares screenshots to cached results and reuses element positions when the screen hasn't changed, reducing AI calls.
- **[Custom error classes](/errors)** — New `ElementNotFoundError` class with rich debugging info including screenshot paths, pixel diffs, and detailed messages.
- **[Events system](/events)** — Listen to SDK lifecycle events with wildcard support via `testdriver.emitter`. Uses colon-delimited namespaces (e.g., `command:start`, `log:*`).
- **[Provision API](/provision)** — Launch browsers, desktop apps, VS Code, and Chrome extensions in your sandbox before tests run. Access via `testdriver.provision.*`.
- **[Redraw detection](/redraw)** — Wait for screens to stabilize after interactions using two-phase detection with pixel comparison and z-score analysis.
- **[Screenshots API](/screenshots)** — Capture screenshots manually with `testdriver.screenshot()` or automatically before/after every command.

📚 New examples

- [Exec output](/examples/exec-output) — Capture and use output from PowerShell commands
- [Exec PowerShell](/examples/exec-pwsh) — Generate dynamic data with PowerShell
- [Focus window](/examples/focus-window) — Switch focus between application windows

🔧 Improvements

- Improved console URL mapping for canary and test environments
- Enhanced Ably channel cleanup for better resource management
- Updated release workflow with improved changelog generation
</Update>

<Update label="v7.5.26" description="March 2026" tags={["stable"]}>
🚀 Stable release

This release promotes v7.5.25 to stable with deployment channel improvements.

✨ Features

- **Deployment channels** — SDK now supports stable and canary release channels. Stable releases use the `latest` npm tag, while canary releases use the `canary` tag. Install canary with `npm install testdriverai@canary`.

🔧 Improvements

- Improved cache hit debugging and logging
- Enhanced element location reliability
- Better error handling during test execution

🐛 Bug fixes

- Fixed restart behavior during auto-updates
- Fixed console URL routing for various environments

<Note>
This release includes changes from v7.5.17 through v7.5.25.
</Note>
</Update>

<Update label="v7.5.25" description="March 2026" tags={["stable"]}>
🐛 Bug fixes

- Fixed restart update behavior
</Update>

<Update label="v7.5.24" description="March 2026" tags={["stable"]}>
🔧 Improvements

- Disabled auto-update restart to improve CI stability
</Update>

<Update label="v7.5.22" description="March 2026" tags={["stable"]}>
🔧 Improvements

- Added markdown-to-HTML rendering for marketing content
</Update>

<Update label="v7.5.19" description="March 2026" tags={["stable"]}>
🔧 Improvements

- Enhanced debugging output for cache hits
- Improved element location reliability
</Update>

<Update label="v7.5.17" description="March 2026" tags={["stable"]}>
🔧 Improvements

- Improved codespace scaling and development environment setup
- Updated VS Code extension version
</Update>