@testdriverai/mcp 7.11.180-test → 7.11.181-test

package/agent/lib/{openrouter-key-error.test.mjs → google-key-error.test.mjs}

@@ -6,8 +6,8 @@ const require = createRequire(import.meta.url);
 const { createSDK, withRetry } = require("./sdk.js");
 
 /**
- * A team's OpenRouter key can be revoked, run out of credit, or never be
- * configured. The API reports that as a 400 carrying an OPENROUTER_* code.
+ * A team's Google (Gemini) key can be revoked, run out of quota, or never be
+ * configured. The API reports that as a 400 carrying a GOOGLE_* code.
  * Two things have to hold for the user to ever see it: the request layer must
  * not retry it into a two-minute stall, and it must arrive as a real error with
  * `isConfigError` set — that flag is what stops find()/findAll() from folding it
@@ -21,12 +21,12 @@ const axiosError = (status, data) =>
 
 const KEY_ERROR_BODY = {
   error:
-    "Your team's OpenRouter API key has no credits remaining — HTTP 402. Add credits at https://openrouter.ai/credits.",
-  code: "OPENROUTER_KEY_ERROR",
-  details: { openrouterStatus: 402, source: "testdriver-locate" },
+    "Your team's Google API key has no quota remaining — HTTP 429. Check your quota at https://aistudio.google.com/apikey.",
+  code: "GOOGLE_KEY_ERROR",
+  details: { geminiStatus: 429, source: "testdriver-locate" },
 };
 
-describe("OpenRouter key errors are not retried", () => {
+describe("Google key errors are not retried", () => {
   it("fails a rejected key on the first attempt", async () => {
     let attempts = 0;
     await expect(
@@ -44,8 +44,8 @@ describe("OpenRouter key errors are not retried", () => {
       withRetry(async () => {
         attempts++;
         throw axiosError(400, {
-          error: "OpenRouter API key is required for self-hosted plans.",
-          code: "OPENROUTER_KEY_REQUIRED",
+          error: "Google API key is required for self-hosted plans.",
+          code: "GOOGLE_KEY_REQUIRED",
         });
       }),
     ).rejects.toThrow();
@@ -81,7 +81,7 @@ describe("OpenRouter key errors are not retried", () => {
   });
 });
 
-describe("OpenRouter key errors reach the caller", () => {
+describe("Google key errors reach the caller", () => {
   /** Serve one 400 with the given body, then hand back its origin. */
   const serve = async (body) => {
     const server = http.createServer((req, res) => {
@@ -112,7 +112,7 @@ describe("OpenRouter key errors reach the caller", () => {
 
       expect(error).toBeTruthy();
       expect(error.isConfigError).toBe(true);
-      expect(error.code).toBe("OPENROUTER_KEY_ERROR");
+      expect(error.code).toBe("GOOGLE_KEY_ERROR");
       expect(error.message).toBe(KEY_ERROR_BODY.error);
       expect(error.details).toEqual(KEY_ERROR_BODY.details);
 

package/agent/lib/sdk.js

@@ -36,6 +36,9 @@ const DEFAULT_RETRY_CONFIG = {
  * retrying only delays the message the user needs to read.
  */
 const CONFIG_ERROR_CODES = [
+  "GOOGLE_KEY_ERROR",
+  "GOOGLE_KEY_REQUIRED",
+  // Kept for backward compatibility with older API deployments.
   "OPENROUTER_KEY_ERROR",
   "OPENROUTER_KEY_REQUIRED",
 ];
@@ -58,7 +61,7 @@ function apiErrorCode(error) {
  * @returns {boolean} Whether the request should be retried
  */
 function isRetryableError(error, config = DEFAULT_RETRY_CONFIG) {
-  // A rejected OpenRouter key (or a missing one) is not going to start working
+  // A rejected Google key (or a missing one) is not going to start working
   // on attempt two — surface it now instead of after ten backoffs.
   if (CONFIG_ERROR_CODES.includes(apiErrorCode(error))) {
     return false;
@@ -607,7 +610,7 @@ const createSDK = (emitter, config, sessionInstance) => {
       const status = error.response?.status;
 
       // Configuration errors (400 + a known code) — the API rejected the call
-      // for a reason the user can fix, most often an OpenRouter key that was
+      // for a reason the user can fix, most often a Google key that was
       // revoked, ran out of credit, or was never configured. These used to
       // arrive as a bare "Request failed with status code 400" and get folded
       // into "element not found", so the real cause never reached the user.

package/docs/self-hosted.mdx

@@ -46,6 +46,10 @@ Run test sandboxes on your AWS infrastructure while using TestDriver's hosted da
 - **Your AI keys** — control costs with your own OpenAI, Anthropic, or other provider
 - **Custom AMIs** — install specific software, configure networking
 
+<Note>
+  **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.
+</Note>
+
 <Card
   title="AWS Setup Guide"
   icon="aws"

package/package.json

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

package/sdk.js

@@ -623,7 +623,7 @@ class Element {
         this.sdk.emitter.emit(events.log.log, notFoundMessage);
       }
     } catch (error) {
-      // A rejected or missing OpenRouter key breaks every find the same way.
+      // A rejected or missing Google key breaks every find the same way.
       // Reporting it as "element not found" hides the one thing the user needs
       // to know, so it escapes instead of being folded into the not-found path.
       if (error.isConfigError) {
@@ -2671,7 +2671,7 @@ CAPTCHA_SOLVER_EOF`,
     } catch (error) {
       const duration = Date.now() - startTime;
 
-      // A rejected or missing OpenRouter key isn't "zero elements matched" —
+      // A rejected or missing Google key isn't "zero elements matched" —
       // returning [] here would hide the only thing the user can act on.
       if (error.isConfigError) {
         this._lastPromiseSettled = true;