testdriverai 7.9.54-test → 7.9.56-canary

package/.claude-plugin/marketplace.json

@@ -0,0 +1,17 @@
+{
+  "name": "testdriver",
+  "version": "7.9.54-test",
+  "description": "TestDriver.ai plugins for Claude Code — MCP server, agent, and skills for building natural-language end-to-end tests.",
+  "repository": "https://github.com/testdriverai/testdriverai",
+  "owner": {
+    "name": "TestDriver.ai",
+    "url": "https://testdriver.ai"
+  },
+  "plugins": [
+    {
+      "name": "testdriver",
+      "source": "./ai",
+      "description": "TestDriver.ai MCP server, TestDriver expert agent, and skills for authoring computer-use end-to-end tests with Vitest."
+    }
+  ]
+}

package/ai/.claude-plugin/plugin.json

@@ -1,9 +1,94 @@
 {
   "name": "testdriver",
-  "description": "TestDriver plugin: SDK guidance plus MCP access to test runs and results.",
-  "version": "1.0.0",
+  "version": "7.9.54-test",
+  "description": "TestDriver.ai Claude Code plugin: MCP server, TestDriver expert agent, and skills for authoring computer-use end-to-end tests with Vitest.",
   "author": {
-    "name": "TestDriver"
-  }
+    "name": "TestDriver.ai",
+    "url": "https://testdriver.ai"
+  },
+  "homepage": "https://docs.testdriver.ai",
+  "repository": "https://github.com/testdriverai/testdriverai",
+  "license": "AGPL-3.0",
+  "keywords": [
+    "testdriver",
+    "testing",
+    "e2e",
+    "mcp",
+    "vitest",
+    "automation",
+    "computer-use",
+    "browser",
+    "ai",
+    "qa"
+  ],
+  "mcpServers": {
+    "testdriver": {
+      "command": "npx",
+      "args": ["-p", "testdriverai", "testdriverai-mcp"],
+      "env": {
+        "TD_API_KEY": "${TD_API_KEY}"
+      }
+    }
+  },
+  "agents": [
+    "./agents/testdriver.md"
+  ],
+  "skills": [
+    "./skills/testdriver-ai",
+    "./skills/testdriver-assert",
+    "./skills/testdriver-aws-setup",
+    "./skills/testdriver-cache",
+    "./skills/testdriver-caching",
+    "./skills/testdriver-captcha",
+    "./skills/testdriver-ci-cd",
+    "./skills/testdriver-click",
+    "./skills/testdriver-client",
+    "./skills/testdriver-cloud",
+    "./skills/testdriver-customizing-devices",
+    "./skills/testdriver-dashcam",
+    "./skills/testdriver-debugging-with-screenshots",
+    "./skills/testdriver-device-config",
+    "./skills/testdriver-double-click",
+    "./skills/testdriver-elements",
+    "./skills/testdriver-enterprise",
+    "./skills/testdriver-errors",
+    "./skills/testdriver-events",
+    "./skills/testdriver-examples",
+    "./skills/testdriver-exec",
+    "./skills/testdriver-find",
+    "./skills/testdriver-focus-application",
+    "./skills/testdriver-generating-tests",
+    "./skills/testdriver-hosted",
+    "./skills/testdriver-hover",
+    "./skills/testdriver-locating-elements",
+    "./skills/testdriver-making-assertions",
+    "./skills/testdriver-mcp",
+    "./skills/testdriver-mcp-workflow",
+    "./skills/testdriver-mouse-down",
+    "./skills/testdriver-mouse-up",
+    "./skills/testdriver-parse",
+    "./skills/testdriver-performing-actions",
+    "./skills/testdriver-press-keys",
+    "./skills/testdriver-provision",
+    "./skills/testdriver-quickstart",
+    "./skills/testdriver-redraw",
+    "./skills/testdriver-reusable-code",
+    "./skills/testdriver-right-click",
+    "./skills/testdriver-running-tests",
+    "./skills/testdriver-screenshot",
+    "./skills/testdriver-screenshots",
+    "./skills/testdriver-scroll",
+    "./skills/testdriver-secrets",
+    "./skills/testdriver-self-hosted",
+    "./skills/testdriver-test-results-json",
+    "./skills/testdriver-test-writer",
+    "./skills/testdriver-testdriver",
+    "./skills/testdriver-testdriver-mechanic",
+    "./skills/testdriver-type",
+    "./skills/testdriver-variables",
+    "./skills/testdriver-wait",
+    "./skills/testdriver-waiting-for-elements",
+    "./skills/testdriver-what-is-testdriver"
+  ]
 }
 

package/ai/agents/testdriver.md

@@ -1,7 +1,7 @@
 ---
 name: testdriver
 description: An expert at creating and refining automated tests using TestDriver.ai
-tools: ['vscode/getProjectSetupInfo', 'vscode/installExtension', 'vscode/newWorkspace', 'vscode/openSimpleBrowser', 'vscode/runCommand', 'vscode/askQuestions', 'vscode/switchAgent', 'vscode/vscodeAPI', 'vscode/extensions', 'execute/runNotebookCell', 'execute/testFailure', 'execute/getTerminalOutput', 'execute/awaitTerminal', 'execute/killTerminal', 'execute/runTask', 'execute/createAndRunTask', 'execute/runInTerminal', 'execute/runTests', 'read/getNotebookSummary', 'read/problems', 'read/readFile', 'read/readNotebookCellOutput', 'read/terminalSelection', 'read/terminalLastCommand', 'read/getTaskOutput', 'agent/runSubagent', 'edit/createDirectory', 'edit/createFile', 'edit/createJupyterNotebook', 'edit/editFiles', 'edit/editNotebook', 'search/changes', 'search/codebase', 'search/fileSearch', 'search/listDirectory', 'search/searchResults', 'search/textSearch', 'search/usages', 'search/searchSubagent', 'web/fetch', 'web/githubRepo', 'testdriver/assert', 'testdriver/check', 'testdriver/click', 'testdriver/exec', 'testdriver/find', 'testdriver/find_and_click', 'testdriver/findall', 'testdriver/focus_application', 'testdriver/hover', 'testdriver/list_local_screenshots', 'testdriver/press_keys', 'testdriver/screenshot', 'testdriver/scroll', 'testdriver/session_extend', 'testdriver/session_start', 'testdriver/session_status', 'testdriver/type', 'testdriver/view_local_screenshot', 'testdriver/wait', 'todo']
+tools: ['vscode/getProjectSetupInfo', 'vscode/installExtension', 'vscode/newWorkspace', 'vscode/openSimpleBrowser', 'vscode/runCommand', 'vscode/askQuestions', 'vscode/switchAgent', 'vscode/vscodeAPI', 'vscode/extensions', 'execute/runNotebookCell', 'execute/testFailure', 'execute/getTerminalOutput', 'execute/awaitTerminal', 'execute/killTerminal', 'execute/runTask', 'execute/createAndRunTask', 'execute/runInTerminal', 'execute/runTests', 'read/getNotebookSummary', 'read/problems', 'read/readFile', 'read/readNotebookCellOutput', 'read/terminalSelection', 'read/terminalLastCommand', 'read/getTaskOutput', 'agent/runSubagent', 'edit/createDirectory', 'edit/createFile', 'edit/createJupyterNotebook', 'edit/editFiles', 'edit/editNotebook', 'search/changes', 'search/codebase', 'search/fileSearch', 'search/listDirectory', 'search/searchResults', 'search/textSearch', 'search/usages', 'search/searchSubagent', 'web/fetch', 'web/githubRepo', 'testdriver/assert', 'testdriver/check', 'testdriver/click', 'testdriver/exec', 'testdriver/find', 'testdriver/find_and_click', 'testdriver/findall', 'testdriver/focus_application', 'testdriver/hover', 'testdriver/init', 'testdriver/list_local_screenshots', 'testdriver/press_keys', 'testdriver/screenshot', 'testdriver/scroll', 'testdriver/session_extend', 'testdriver/session_start', 'testdriver/session_status', 'testdriver/type', 'testdriver/view_local_screenshot', 'testdriver/wait', 'todo']
 mcp-servers:
   testdriver:
     command: npx

package/ai/skills/testdriver-mcp-workflow/SKILL.md

@@ -294,7 +294,7 @@ When creating a new test project, use these exact dependencies:
 {
   "type": "module",
   "devDependencies": {
-    "testdriverai": "beta",
+    "testdriverai": "canary",
     "vitest": "^4.0.0"
   },
   "scripts": {
@@ -303,7 +303,7 @@ When creating a new test project, use these exact dependencies:
 }
 ```
 
-**Important:** The package is `testdriverai` (NOT `@testdriverai/sdk`). Always install from the `beta` tag.
+**Important:** The package is `testdriverai` (NOT `@testdriverai/sdk`). Always install from the `canary` tag.
 
 ## Test File Format
 

package/ai/skills/testdriver-test-writer/SKILL.md

@@ -50,12 +50,12 @@ Get your API key at: **https://console.testdriver.ai/team**
 
 ### Installation
 
-Always use the **beta** tag when installing TestDriver:
+Always use the **canary** tag when installing TestDriver:
 
 ```bash
-npm install --save-dev testdriverai@beta
+npm install --save-dev testdriverai@canary
 # or
-npx testdriverai@beta init
+npx testdriverai@canary init
 ```
 
 ### Test Runner

package/docs/claude-mcp-plugin.mdx

@@ -2,29 +2,74 @@
 title: Using TestDriver with Claude Code (MCP)
 ---
 
-TestDriver exposes test results and analytics over an **HTTP MCP server**, so Claude Code (or any MCP-compatible client) can inspect your test runs, failures, and filters.
+TestDriver ships as a native [Claude Code plugin](https://docs.claude.com/en/docs/claude-code/plugins) that bundles the **TestDriver MCP server**, the **`testdriver` expert sub-agent**, and all **TestDriver skills**. You get everything you need to drive TestDriver from Claude Code with a single install.
 
-This guide assumes:
+> The plugin lives inside the `testdriverai` npm package at `ai/.claude-plugin/plugin.json`, and the marketplace entry lives at `.claude-plugin/marketplace.json` in this repo.
 
-- Your API server is running the MCP endpoint at `POST /api/v1/mcp`
-- You have a **team or user API key** for authentication
-- You are using this repo (`testdriverai`) as the SDK / local tooling
-
-## 1. Configure an API key
-
-Get your API key from the team settings:
+## 1. Get a TestDriver API key
 
 - Visit your team page (e.g. `https://console.testdriver.ai/team`)
 - Create or copy a **Team API Key** (or User API Key)
-- Store it locally as an environment variable, for example:
+- Export it in your shell so Claude Code can pass it to the MCP server:
+
+  ```bash
+  export TD_API_KEY="your_api_key_here"
+  ```
+
+## 2. Install the plugin in Claude Code
+
+From inside Claude Code, add this repo as a plugin marketplace and install the `testdriver` plugin:
+
+```text
+/plugin marketplace add testdriverai/testdriverai
+/plugin install testdriver@testdriver
+```
 
-```bash
-export TD_API_KEY="your_api_key_here"
+That registers three things:
+
+- **`testdriver` MCP server** — spawned via `npx -p testdriverai testdriverai-mcp`, with `TD_API_KEY` forwarded from your environment.
+- **`testdriver` sub-agent** — the TestDriver expert agent from `ai/agents/testdriver.md`. Invoke it with `@testdriver ...`.
+- **TestDriver skills** — every `ai/skills/testdriver-*` skill, auto-loaded by Claude Code.
+
+## 3. Write tests with the agent
+
+In a Claude Code session, delegate to the agent:
+
+```text
+@testdriver Write a test that signs into https://example.com and adds an item to the cart.
 ```
 
-The MCP server expects this API key in the `X-Api-Key` header (or `Authorization: Bearer <key>`).
+The agent will use the TestDriver MCP tools (`session_start`, `find`, `click`, `type`, `assert`, …) to interactively build a Vitest test, append generated code to your test file after every action, and run it with `vitest run` until it passes.
+
+For the full agent guide, see the [`testdriver` agent definition](https://github.com/testdriverai/testdriverai/blob/main/ai/agents/testdriver.md) and the [MCP workflow skill](https://github.com/testdriverai/testdriverai/blob/main/ai/skills/testdriver-mcp-workflow/SKILL.md).
 
-## 2. HTTP MCP endpoint contract
+## Manual MCP configuration (no plugin)
+
+If you prefer not to use the plugin, you can register the MCP server manually in any MCP-compatible client (Claude Desktop, Cursor, VS Code, …):
+
+```json
+{
+  "mcpServers": {
+    "testdriver": {
+      "command": "npx",
+      "args": ["-p", "testdriverai", "testdriverai-mcp"],
+      "env": {
+        "TD_API_KEY": "${TD_API_KEY}"
+      }
+    }
+  }
+}
+```
+
+This is the same config the plugin wires up for you — the plugin just bundles it alongside the agent and skills.
+
+---
+
+## Observing test runs via HTTP MCP
+
+TestDriver also exposes **test results and analytics** over an HTTP MCP endpoint, so Claude Code (or any MCP-compatible client) can inspect your test runs, failures, and filters without provisioning a sandbox.
+
+### HTTP MCP endpoint contract
 
 The HTTP endpoint lives at:
 
@@ -32,6 +77,8 @@ The HTTP endpoint lives at:
 POST /api/v1/mcp
 ```
 
+It expects the TestDriver API key in the `X-Api-Key` header (or `Authorization: Bearer <key>`).
+
 Common request shapes:
 
 - **List tools**
@@ -89,7 +136,7 @@ The MCP server advertises at least these tools in `list_tools`:
 - `get_filter_options`  
   Get branch, suite, repo, filename, commit, status, platform, and test name options for building queries.
 
-## 3. Claude Code MCP server configuration
+### Pointing Claude Code at the HTTP MCP endpoint
 
 You can point Claude Code at the HTTP MCP endpoint using a JSON configuration similar to:
 
@@ -137,12 +184,12 @@ For local development:
 }
 ```
 
-## 4. Skills documentation for Claude
+### Skills documentation for Claude
 
-Claude Code expects a `SKILLs.md` file to explain how to use a server. In this repo:
+Claude Code loads the agent and skills automatically when you install the plugin (see step 2). The underlying sources are:
 
 - `ai/agents/testdriver.md` contains the **full TestDriver Agent Guide**
-- `SKILLs.md` acts as a short wrapper that points Claude (and other agents) to the agent guide
+- `ai/skills/testdriver-*/SKILL.md` provide task-specific skills (MCP workflow, assertions, provisioning, etc.)
 
 Use these as the primary reference for:
 

package/mcp-server/README.md

@@ -89,6 +89,38 @@ To use the TestDriver MCP server with GitHub Copilot coding agent:
 
 For more information, see [Extending GitHub Copilot coding agent with Model Context Protocol](https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-coding-agent-with-mcp).
 
+### With Claude Code (plugin)
+
+TestDriver ships as a [Claude Code plugin](https://docs.claude.com/en/docs/claude-code/plugins) so you get the MCP server, the `testdriver` expert agent, and all TestDriver skills with a single install.
+
+1. Set your TestDriver API key in your shell:
+
+   ```bash
+   export TD_API_KEY=your_api_key_from_https_console_testdriver_ai_team
+   ```
+
+2. Add this repo as a Claude Code plugin marketplace and install the `testdriver` plugin:
+
+   ```bash
+   # Add the marketplace (sources `.claude-plugin/marketplace.json` from this repo)
+   /plugin marketplace add testdriverai/testdriverai
+
+   # Install the plugin
+   /plugin install testdriver@testdriver
+   ```
+
+   This reads `.claude-plugin/plugin.json` (shipped inside the `testdriverai` npm package) and:
+
+   - Registers the `testdriver` MCP server (`npx -p testdriverai testdriverai-mcp`)
+   - Registers the `testdriver` sub-agent (from `ai/agents/testdriver.md`)
+   - Registers all TestDriver skills (from `ai/skills/testdriver-*/SKILL.md`)
+
+3. In a Claude Code session, delegate to the agent with:
+
+   ```text
+   @testdriver Write a test that signs into example.com and adds an item to the cart.
+   ```
+
 ### With Claude Desktop / Cursor
 
 Add to your MCP config (`~/.cursor/mcp.json` or `~/Library/Application Support/Claude/claude_desktop_config.json`):

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "testdriverai",
-  "version": "7.9.54-test",
+  "version": "7.9.56-canary",
   "description": "Next generation autonomous AI agent for end-to-end testing of web & desktop",
   "main": "sdk.js",
   "types": "sdk.d.ts",