@testdriverai/agent 7.11.239-test → 7.11.241-canary

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (52) hide show
  1. package/ai/skills/testdriver-agent/SKILL.md +174 -91
  2. package/ai/skills/testdriver-assert/SKILL.md +73 -269
  3. package/ai/skills/testdriver-aws-setup/SKILL.md +194 -312
  4. package/ai/skills/testdriver-bring-your-own-machine/SKILL.md +137 -204
  5. package/ai/skills/testdriver-cache/SKILL.md +142 -149
  6. package/ai/skills/testdriver-caching/SKILL.md +97 -87
  7. package/ai/skills/testdriver-captcha/SKILL.md +126 -111
  8. package/ai/skills/testdriver-ci-cd/SKILL.md +153 -542
  9. package/ai/skills/testdriver-click/SKILL.md +74 -229
  10. package/ai/skills/testdriver-client/SKILL.md +175 -229
  11. package/ai/skills/testdriver-customizing-devices/SKILL.md +72 -250
  12. package/ai/skills/testdriver-dashcam/SKILL.md +71 -404
  13. package/ai/skills/testdriver-debugging-with-screenshots/SKILL.md +103 -369
  14. package/ai/skills/testdriver-double-click/SKILL.md +46 -67
  15. package/ai/skills/testdriver-errors/SKILL.md +102 -176
  16. package/ai/skills/testdriver-events/SKILL.md +170 -327
  17. package/ai/skills/testdriver-exec/SKILL.md +92 -256
  18. package/ai/skills/testdriver-extract/SKILL.md +69 -170
  19. package/ai/skills/testdriver-find/SKILL.md +140 -736
  20. package/ai/skills/testdriver-focus-application/SKILL.md +69 -246
  21. package/ai/skills/testdriver-generating-tests/SKILL.md +102 -136
  22. package/ai/skills/testdriver-hosted/SKILL.md +79 -143
  23. package/ai/skills/testdriver-hover/SKILL.md +62 -235
  24. package/ai/skills/testdriver-locating-elements/SKILL.md +71 -366
  25. package/ai/skills/testdriver-making-assertions/SKILL.md +114 -72
  26. package/ai/skills/testdriver-mcp-setup/SKILL.md +79 -62
  27. package/ai/skills/testdriver-mouse-down/SKILL.md +46 -124
  28. package/ai/skills/testdriver-mouse-up/SKILL.md +45 -128
  29. package/ai/skills/testdriver-options/SKILL.md +73 -46
  30. package/ai/skills/testdriver-parse/SKILL.md +95 -184
  31. package/ai/skills/testdriver-performing-actions/SKILL.md +101 -91
  32. package/ai/skills/testdriver-press-keys/SKILL.md +59 -299
  33. package/ai/skills/testdriver-provision/SKILL.md +135 -179
  34. package/ai/skills/testdriver-quickstart/SKILL.md +24 -8
  35. package/ai/skills/testdriver-quickstart-claude/SKILL.md +84 -0
  36. package/ai/skills/testdriver-quickstart-github/SKILL.md +62 -32
  37. package/ai/skills/testdriver-quickstart-manual/SKILL.md +59 -32
  38. package/ai/skills/testdriver-quickstart-vscode/SKILL.md +96 -0
  39. package/ai/skills/testdriver-redraw/SKILL.md +100 -164
  40. package/ai/skills/testdriver-reusable-code/SKILL.md +95 -199
  41. package/ai/skills/testdriver-right-click/SKILL.md +45 -88
  42. package/ai/skills/testdriver-screenshot/SKILL.md +47 -201
  43. package/ai/skills/testdriver-screenshots/SKILL.md +86 -136
  44. package/ai/skills/testdriver-scroll/SKILL.md +71 -154
  45. package/ai/skills/testdriver-secrets/SKILL.md +94 -90
  46. package/ai/skills/testdriver-self-hosted/SKILL.md +82 -140
  47. package/ai/skills/testdriver-test-results-json/SKILL.md +165 -202
  48. package/ai/skills/testdriver-type/SKILL.md +56 -304
  49. package/ai/skills/testdriver-variables/SKILL.md +119 -80
  50. package/ai/skills/testdriver-wait/SKILL.md +31 -29
  51. package/ai/skills/testdriver-what-is-testdriver/SKILL.md +80 -32
  52. package/package.json +1 -1
@@ -1,160 +1,102 @@
1
1
  ---
2
2
  name: testdriver:self-hosted
3
- description: Our enterprise solution with unlimited test execution, assisted setup, and dedicated support.
3
+ description: Run TestDriver sandboxes on your own infrastructure for a flat license fee instead of testing minutes.
4
4
  ---
5
5
  <!-- Generated from self-hosted.mdx. DO NOT EDIT. -->
6
6
 
7
- Self-hosted is our enterprise solution. Use it for teams that need unlimited test runs, infrastructure control, and dedicated support. The price uses **parallel test capacity** with a flat license fee. There is no per-second bill.
7
+ import { EnterpriseBadge, EnterpriseCta } from '/snippets/enterprise.mdx';
8
+
9
+ On the Enterprise plan, your tests run on machines in your own infrastructure instead of TestDriver's cloud.
10
+
11
+ <EnterpriseCta feature="Self-hosting" />
12
+
13
+ - You pay a flat license fee per parallel test, with no testing minutes to meter.
14
+ - Your app and test data stay in your environment.
15
+ - You use your own AI provider key and your own VM images.
16
+
17
+ ## What runs where
18
+
19
+ Self-hosting moves the machines that run your tests. TestDriver still hosts the rest.
20
+
21
+ | Component | Where it runs |
22
+ | --- | --- |
23
+ | Test sandboxes and runners | Your AWS account, or your own machines |
24
+ | AI calls | Your own Gemini API key |
25
+ | TestDriver API | TestDriver |
26
+ | Console, recordings, and reports | TestDriver, at [console.testdriver.ai](https://console.testdriver.ai) |
27
+
28
+ ## Ways to run sandboxes
8
29
 
9
30
  <CardGroup cols={2}>
10
- <Card title="Unlimited Execution" icon="infinity">
11
- Run as many tests as you want. There is no device-second count. The monthly costs are known.
12
- </Card>
13
- <Card title="Assisted Setup & Support" icon="headset">
14
- Our team helps you to deploy, configure, and optimize your infrastructure. Dedicated engineering support is included.
31
+ <Card title="AWS" icon="aws" href="/aws-setup">
32
+ Start a fresh Windows EC2 instance for each test with CloudFormation.
15
33
  </Card>
16
- <Card title="Full Control" icon="gear">
17
- Use your own AI keys, custom hardware, specific software, and network configurations. Use RDP into the test machines for debug.
18
- </Card>
19
- <Card title="Security & Compliance" icon="shield-check">
20
- Keep the data in your environment. Air-gapped deployment is available for regulated industries.
34
+ <Card title="Your own machine" icon="display" href="/bring-your-own-machine">
35
+ Run the runner on a laptop, lab machine, or on-prem VM.
21
36
  </Card>
22
37
  </CardGroup>
23
38
 
24
- ## Deployment Options
39
+ Self-hosted teams that use their own AI key can't use TestDriver's managed Windows sandboxes. Run Windows tests on your own instances instead.
25
40
 
26
- Select the level of control that you need:
41
+ ## Use your own AI key
27
42
 
28
- | Component | Standard | Air-Gapped |
29
- |-----------|----------|------------|
30
- | **Test Sandboxes** | Your AWS | Your infrastructure (any cloud or on-prem) |
31
- | **Dashboard** | TestDriver hosted | Your infrastructure |
32
- | **API** | TestDriver hosted | Your infrastructure |
33
- | **AI Processing** | Your API keys | Your infrastructure |
34
- | **Data Storage** | Your AWS account | 100% your infrastructure |
35
- | **Network** | Internet access required | Fully air-gapped |
36
- | **Cloud Providers** | AWS | AWS, Azure, GCP, on-prem |
43
+ Self-hosted teams send AI requests through their own Google Gemini key. Add it on the [API keys page](https://console.testdriver.ai/team/api-keys) under **Business API Keys**.
37
44
 
38
- ### Standard Deployment
45
+ <Note>
46
+ The key must be a [Gemini Enterprise Agent Platform express mode API key](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/start/api-keys?usertype=expressmode). Google AI Studio keys aren't supported.
47
+ </Note>
39
48
 
40
- Run test sandboxes on your AWS infrastructure while using TestDriver's hosted dashboard and API:
49
+ The same page has optional fields for an OpenRouter key and an E2B key.
41
50
 
42
- - **Quick setup** via CloudFormation — deploy in hours
43
- - **Dashboard access** at [console.testdriver.ai](https://console.testdriver.ai)
44
- - **Your AI keys** — control costs with your own OpenAI, Anthropic, or other provider
45
- - **Custom AMIs** — install specific software, configure networking
51
+ ## Use custom VM images
46
52
 
47
- <Note>
48
- **Bring your own Gemini API key.** TestDriver uses Google Gemini for vision and reasoning. When supplying your own Gemini key, it must be a [Gemini Enterprise Agent Platform express mode API key](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/start/api-keys?usertype=expressmode) — standard Google AI Studio (Generative Language API) keys are not supported for self-hosted deployments.
49
- </Note>
53
+ Build a VM image with your apps, dependencies, and test data preinstalled, so tests skip setup steps.
50
54
 
51
- <CardGroup cols={2}>
52
- <Card
53
- title="AWS Setup Guide"
54
- icon="aws"
55
- href="/aws-setup"
56
- >
57
- Step-by-step instructions for deploying TestDriver on your AWS infrastructure using CloudFormation.
58
- </Card>
59
- <Card
60
- title="Run on Your Own Machine"
61
- icon="display"
62
- href="/bring-your-own-machine"
63
- >
64
- Run the runner on a laptop, lab machine, or on-prem VM and drive it from your tests.
65
- </Card>
66
- </CardGroup>
55
+ 1. Start from the TestDriver base image, which TestDriver shares with your AWS account.
56
+ 2. Install your software with the TestDriver Packer scripts, or by hand over RDP.
57
+ 3. Build your own AMI.
58
+ 4. Set `AMI_ID` to your AMI when you run tests. See [AWS setup](/aws-setup#create-a-custom-ami).
59
+
60
+ You can customize, for example:
61
+
62
+ - Applications, browsers, and developer tools.
63
+ - User accounts, proxies, and certificates.
64
+ - Fonts, language packs, and locales.
65
+ - Seeded databases and test fixtures.
66
+
67
+ ## Debug on the machine
68
+
69
+ Self-hosted sandboxes run in your account, so you can connect to a running instance over RDP while a test runs. See [Connect to an instance](/aws-setup#connect-to-an-instance).
70
+
71
+ ## Air-gapped deployment
72
+
73
+ For regulated environments, TestDriver can also deploy the API and console inside your network, on AWS, Azure, GCP, or on-premises. [Contact TestDriver](https://testdriver.ai/enterprise) to discuss it.
74
+
75
+ ## Pricing
76
+
77
+ - A flat monthly fee that includes 2 parallel tests and 5 seats.
78
+ - Unlimited testing, with no per-minute fees.
79
+ - Extra parallel licenses are $250 per month each. Extra seats are $100 per month each.
80
+ - Setup help and support from TestDriver engineers in a shared Slack or Teams channel.
81
+ - A 30-day pilot with a money-back guarantee.
82
+
83
+ See [testdriver.ai/enterprise](https://testdriver.ai/enterprise) for current pricing and terms.
84
+
85
+ ## Hosted or self-hosted
86
+
87
+ | | Hosted | Self-hosted |
88
+ | --- | --- | --- |
89
+ | **Billing** | Testing minutes | Flat license fee |
90
+ | **Sandboxes** | TestDriver's cloud | Your AWS account or machines |
91
+ | **AI key** | TestDriver's | Your own Gemini key |
92
+ | **VM images** | Standard | Your own |
93
+ | **Video replays** | Yes | Yes |
94
+ | **RDP into the machine** | No | Yes, while tests run |
95
+ | **Mac desktop apps** | No | Yes |
96
+ | **Support** | Community or private | Dedicated engineers |
97
+
98
+ ## Get started
67
99
 
68
- ### Air-Gapped Deployment
69
-
70
- Deploy the entire TestDriver stack in your environment for complete isolation:
71
-
72
- - **Full stack** — dashboard, API, and test infrastructure all in your environment
73
- - **No external dependencies** — data never leaves your network perimeter
74
- - **Any infrastructure** — AWS, Azure, GCP, or on-premises
75
- - **Regulated industries** — government, defense, healthcare, finance
76
-
77
- ## Custom VM Images
78
-
79
- Build test environments with your applications, dependencies, and user data pre-installed. You get full access to:
80
-
81
- - **Golden VM** — our pre-configured base image with TestDriver agent, drivers, and optimizations
82
- - **Packer scripts** — build custom AMIs with your applications, user data, and configurations
83
- - **Faster test startup** — skip installation steps by baking dependencies into your image
84
- - **Consistent environments** — every test runs on an identical, reproducible machine
85
-
86
- <AccordionGroup>
87
- <Accordion title="What can you customize?">
88
- - Install applications (browsers, desktop apps, dev tools)
89
- - Configure user accounts and credentials
90
- - Set up network proxies and certificates
91
- - Install fonts, language packs, and locales
92
- - Pre-seed databases or test fixtures
93
- - Configure Windows/Linux settings
94
- </Accordion>
95
-
96
- <Accordion title="How it works">
97
- 1. We provide our golden VM base image and Packer scripts
98
- 2. You customize the scripts to install your software and configuration
99
- 3. Run Packer to build your custom AMI
100
- 4. Configure TestDriver to use your custom AMI for test sandboxes
101
- 5. Tests spin up with everything pre-installed — no setup time wasted
102
- </Accordion>
103
- </AccordionGroup>
104
-
105
- ## Implementation Process
106
-
107
- <Steps>
108
- <Step title="Discovery Call">
109
- Discuss your requirements, security constraints, and integration needs with our team.
110
- </Step>
111
-
112
- <Step title="Architecture Review">
113
- Our engineers design a deployment architecture that meets your security and compliance requirements.
114
- </Step>
115
-
116
- <Step title="Deployment">
117
- We work with your team to deploy TestDriver, including assisted setup and configuration.
118
- </Step>
119
-
120
- <Step title="Integration">
121
- Connect TestDriver to your CI/CD pipelines, internal tools, and workflows.
122
- </Step>
123
-
124
- <Step title="Training & Handoff">
125
- Comprehensive training for your team on operating and maintaining the deployment.
126
- </Step>
127
- </Steps>
128
-
129
- ## What's Included
130
-
131
- - **Flat license fee** per parallel test slot
132
- - **Unlimited test execution** — no device-second charges
133
- - **Assisted setup** — our team helps you deploy and configure
134
- - **Dedicated support** — direct access to our engineering team
135
- - **Custom contract terms** — volume-based pricing, custom SLAs
136
- - **Professional services** — implementation assistance and training
137
-
138
- ## Comparison: Hosted vs Self-Hosted
139
-
140
- | Feature | Hosted | Self-Hosted |
141
- |---------|--------|-------------|
142
- | **Setup Time** | Minutes | Hours (assisted) |
143
- | **Pricing Model** | Device-seconds | Flat license fee |
144
- | **Infrastructure** | TestDriver | Your AWS or any cloud |
145
- | **AI API Keys** | TestDriver's | Your own |
146
- | **Custom Software** | Limited | Full control |
147
- | **Hardware Selection** | Standard | Your choice |
148
- | **Debugging Access** | Replays only | Full RDP access |
149
- | **Support** | Community/Standard | Dedicated engineering |
150
- | **Air-Gapped Option** | No | Yes |
151
-
152
- ## Get Started
153
-
154
- <Card
155
- title="Schedule a Consultation"
156
- icon="calendar"
157
- href="https://testdriver.ai/enterprise"
158
- >
159
- Discuss your requirements with our team and get a custom proposal for your self-hosted deployment.
100
+ <Card title="Talk to TestDriver" icon="calendar" href="https://testdriver.ai/enterprise">
101
+ Plan a self-hosted deployment with the TestDriver team.
160
102
  </Card>