@popoverai/dotrequirements 0.22.0 → 0.24.0

package/dist/utils/env.js

@@ -1,5 +1,5 @@
-import * as fs from 'fs';
-import * as path from 'path';
+import * as fs from "node:fs";
+import * as path from "node:path";
 /**
  * Load environment variables from .env.local file
  * Merges with existing process.env (process.env takes precedence by default)
@@ -7,16 +7,16 @@ import * as path from 'path';
  * @param force - If true, overwrite existing process.env values (used when reloading after init)
  */
 export function loadEnvFile(cwd = process.cwd(), force = false) {
-    const envPath = path.join(cwd, '.env.local');
+    const envPath = path.join(cwd, ".env.local");
     if (!fs.existsSync(envPath)) {
         return;
     }
     try {
-        const content = fs.readFileSync(envPath, 'utf-8');
-        const lines = content.split('\n');
+        const content = fs.readFileSync(envPath, "utf-8");
+        const lines = content.split("\n");
         for (const line of lines) {
             // Skip empty lines and comments
-            if (!line.trim() || line.trim().startsWith('#')) {
+            if (!line.trim() || line.trim().startsWith("#")) {
                 continue;
             }
             // Parse KEY=VALUE format
@@ -31,7 +31,7 @@ export function loadEnvFile(cwd = process.cwd(), force = false) {
             }
         }
     }
-    catch (error) {
+    catch {
         // Silently fail if we can't read the file
         // The commands will error appropriately if env vars are missing
     }

package/dist/utils/gitignore.js

@@ -1,14 +1,14 @@
-import * as fs from 'fs';
-import * as path from 'path';
+import * as fs from "node:fs";
+import * as path from "node:path";
 /**
  * Ensure project-settings.json is in .gitignore
  * Creates .gitignore if it doesn't exist
  * Appends the entry if not already present
  */
 export function ensureGitignore(cwd = process.cwd()) {
-    const gitignorePath = path.join(cwd, '.gitignore');
-    const entryToAdd = '.requirements/project-settings.json';
-    const comment = '# dotrequirements credentials';
+    const gitignorePath = path.join(cwd, ".gitignore");
+    const entryToAdd = ".requirements/project-settings.json";
+    const comment = "# dotrequirements credentials";
     // Check if .gitignore exists
     if (!fs.existsSync(gitignorePath)) {
         // Create new .gitignore
@@ -16,13 +16,13 @@ export function ensureGitignore(cwd = process.cwd()) {
         return;
     }
     // Read existing .gitignore
-    const content = fs.readFileSync(gitignorePath, 'utf-8');
+    const content = fs.readFileSync(gitignorePath, "utf-8");
     // Check if entry is already present
     if (content.includes(entryToAdd)) {
         return; // Already present, nothing to do
     }
     // Append to .gitignore
-    const separator = content.endsWith('\n') ? '' : '\n';
+    const separator = content.endsWith("\n") ? "" : "\n";
     const newContent = `${content}${separator}\n${comment}\n${entryToAdd}\n`;
     fs.writeFileSync(gitignorePath, newContent);
 }

package/dist/utils/oauth-callback-server.d.ts

@@ -4,7 +4,7 @@
  * Creates a temporary server on localhost to receive the OAuth redirect.
  * Implements AUTH-5: Local callback server for OAuth redirect
  */
-import * as http from 'http';
+import * as http from "node:http";
 export interface CallbackResult {
     code: string;
     state: string;

package/dist/utils/oauth-callback-server.js

@@ -4,8 +4,8 @@
  * Creates a temporary server on localhost to receive the OAuth redirect.
  * Implements AUTH-5: Local callback server for OAuth redirect
  */
-import * as http from 'http';
-import { URL } from 'url';
+import * as http from "node:http";
+import { URL } from "node:url";
 /**
  * Start a local HTTP server and wait for OAuth callback
  *
@@ -17,24 +17,24 @@ export async function startCallbackServer(options = {}) {
         let timeout;
         const server = http.createServer((req, res) => {
             // Only handle GET requests to the callback path
-            if (req.method !== 'GET' || !req.url) {
+            if (req.method !== "GET" || !req.url) {
                 res.writeHead(404);
-                res.end('Not Found');
+                res.end("Not Found");
                 return;
             }
             try {
                 // Parse the callback URL
                 const address = server.address();
-                const port = address && typeof address !== 'string' ? address.port : 3000;
+                const port = address && typeof address !== "string" ? address.port : 3000;
                 const callbackUrl = new URL(req.url, `http://localhost:${port}`);
-                const code = callbackUrl.searchParams.get('code');
-                const state = callbackUrl.searchParams.get('state');
-                const error = callbackUrl.searchParams.get('error');
-                const errorDescription = callbackUrl.searchParams.get('error_description');
+                const code = callbackUrl.searchParams.get("code");
+                const state = callbackUrl.searchParams.get("state");
+                const error = callbackUrl.searchParams.get("error");
+                const errorDescription = callbackUrl.searchParams.get("error_description");
                 // Handle OAuth errors
                 if (error) {
                     const message = errorDescription || error;
-                    res.writeHead(400, { 'Content-Type': 'text/html; charset=utf-8' });
+                    res.writeHead(400, { "Content-Type": "text/html; charset=utf-8" });
                     res.end(`
             <!DOCTYPE html>
             <html>
@@ -60,7 +60,7 @@ export async function startCallbackServer(options = {}) {
                 }
                 // Validate required parameters
                 if (!code || !state) {
-                    res.writeHead(400, { 'Content-Type': 'text/html; charset=utf-8' });
+                    res.writeHead(400, { "Content-Type": "text/html; charset=utf-8" });
                     res.end(`
             <!DOCTYPE html>
             <html>
@@ -81,11 +81,11 @@ export async function startCallbackServer(options = {}) {
           `);
                     clearTimeout(timeout);
                     server.close();
-                    reject(new Error('Invalid callback: missing code or state'));
+                    reject(new Error("Invalid callback: missing code or state"));
                     return;
                 }
                 // Success response
-                res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+                res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
                 res.end(`
           <!DOCTYPE html>
           <html>
@@ -109,8 +109,8 @@ export async function startCallbackServer(options = {}) {
                 resolve({ code, state });
             }
             catch (err) {
-                res.writeHead(500, { 'Content-Type': 'text/plain' });
-                res.end('Internal Server Error');
+                res.writeHead(500, { "Content-Type": "text/plain" });
+                res.end("Internal Server Error");
                 clearTimeout(timeout);
                 server.close();
                 reject(err);
@@ -119,15 +119,15 @@ export async function startCallbackServer(options = {}) {
         // Set timeout
         timeout = setTimeout(() => {
             server.close();
-            reject(new Error('OAuth callback timeout: no response received within 2 minutes'));
+            reject(new Error("OAuth callback timeout: no response received within 2 minutes"));
         }, timeoutMs);
         // Handle server errors
-        server.on('error', (err) => {
+        server.on("error", (err) => {
             clearTimeout(timeout);
             reject(err);
         });
         // Start listening on specified port (0 = random available port)
-        server.listen(port, 'localhost');
+        server.listen(port, "localhost");
     });
 }
 /**
@@ -137,9 +137,11 @@ export async function startCallbackServer(options = {}) {
  */
 export function getCallbackUrl(server) {
     const address = server.address();
-    if (!address || typeof address === 'string') {
-        throw new Error('Server is not listening on a network address');
+    if (!address || typeof address === "string") {
+        throw new Error("Server is not listening on a network address");
     }
+    // Node's `server.address()` returns `string | AddressInfo | null`; we're
+    // inside a server.listen() callback so we know it's an AddressInfo here.
     return `http://localhost:${address.port}/callback`;
 }
 /**
@@ -147,10 +149,10 @@ export function getCallbackUrl(server) {
  */
 function escapeHtml(str) {
     return str
-        .replace(/&/g, '&amp;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;')
-        .replace(/'/g, '&#039;');
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&#039;");
 }
 //# sourceMappingURL=oauth-callback-server.js.map

package/dist/utils/oauth-flow.js

@@ -4,14 +4,14 @@
  * Coordinates browser launch, callback server, and token exchange.
  * Implements AUTH-24: OAuth flow orchestration
  */
-import { randomBytes } from 'crypto';
-import { ConvexHttpClient } from 'convex/browser';
-import { startCallbackServer } from './oauth-callback-server.js';
-import { openBrowserWithFallback } from './browser-launch.js';
-import { getConvexUrl } from '../config.js';
-import { api } from '../convex.js';
-const WORKOS_CLIENT_ID = 'client_01KCM6WPYX201P7DRV5DHF4TR7';
-const WORKOS_AUTHORIZE_URL = 'https://api.workos.com/user_management/authorize';
+import { randomBytes } from "node:crypto";
+import { ConvexHttpClient } from "convex/browser";
+import { getConvexUrl } from "../config.js";
+import { api } from "../convex.js";
+import { openBrowserWithFallback } from "./browser-launch.js";
+import { startCallbackServer } from "./oauth-callback-server.js";
+const WORKOS_CLIENT_ID = "client_01KCM6WPYX201P7DRV5DHF4TR7";
+const WORKOS_AUTHORIZE_URL = "https://api.workos.com/user_management/authorize";
 /**
  * Execute the full OAuth flow:
  * 1. Start local callback server
@@ -25,10 +25,13 @@ export async function executeOAuthFlow() {
     const codeVerifier = generateCodeVerifier();
     const codeChallenge = await generateCodeChallenge(codeVerifier);
     const state = generateState();
-    console.log('Starting authentication flow...');
+    console.log("Starting authentication flow...");
     // Start local callback server on port 3010 (WorkOS requires pre-configured redirect URI)
-    const redirectUri = 'http://localhost:3010/callback';
-    const callbackPromise = startCallbackServer({ port: 3010, timeoutMs: 120000 });
+    const redirectUri = "http://localhost:3010/callback";
+    const callbackPromise = startCallbackServer({
+        port: 3010,
+        timeoutMs: 120000,
+    });
     // Build authorization URL
     const authUrl = buildAuthorizationUrl({
         clientId: WORKOS_CLIENT_ID,
@@ -38,14 +41,14 @@ export async function executeOAuthFlow() {
     });
     // Open browser for user authentication
     await openBrowserWithFallback(authUrl);
-    console.log('Waiting for authentication in browser...');
+    console.log("Waiting for authentication in browser...");
     // Wait for OAuth callback
     const { code, state: returnedState } = await callbackPromise;
     // Verify state to prevent CSRF attacks
     if (state !== returnedState) {
-        throw new Error('Invalid state parameter: possible CSRF attack');
+        throw new Error("Invalid state parameter: possible CSRF attack");
     }
-    console.log('Authentication successful, exchanging code for tokens...');
+    console.log("Authentication successful, exchanging code for tokens...");
     // Exchange authorization code for tokens via Convex action (server-side WorkOS call)
     const client = new ConvexHttpClient(getConvexUrl());
     const result = await client.action(api.lib.authActions.exchangeAuthorizationCode, {
@@ -56,7 +59,7 @@ export async function executeOAuthFlow() {
         throw new Error(`Token exchange failed: ${result.error}`);
     }
     const { accessToken, refreshToken, expiresAt } = result;
-    console.log('✓ Authentication complete!');
+    console.log("✓ Authentication complete!");
     return {
         accessToken,
         refreshToken,
@@ -68,14 +71,14 @@ export async function executeOAuthFlow() {
  */
 function buildAuthorizationUrl(params) {
     const url = new URL(WORKOS_AUTHORIZE_URL);
-    url.searchParams.set('client_id', params.clientId);
-    url.searchParams.set('redirect_uri', params.redirectUri);
-    url.searchParams.set('response_type', 'code');
-    url.searchParams.set('state', params.state);
-    url.searchParams.set('code_challenge', params.codeChallenge);
-    url.searchParams.set('code_challenge_method', 'S256');
-    url.searchParams.set('scope', 'openid profile email offline_access');
-    url.searchParams.set('provider', 'authkit');
+    url.searchParams.set("client_id", params.clientId);
+    url.searchParams.set("redirect_uri", params.redirectUri);
+    url.searchParams.set("response_type", "code");
+    url.searchParams.set("state", params.state);
+    url.searchParams.set("code_challenge", params.codeChallenge);
+    url.searchParams.set("code_challenge_method", "S256");
+    url.searchParams.set("scope", "openid profile email offline_access");
+    url.searchParams.set("provider", "authkit");
     return url.toString();
 }
 /**
@@ -88,8 +91,8 @@ function generateCodeVerifier() {
  * Generate code challenge from verifier using SHA-256
  */
 async function generateCodeChallenge(verifier) {
-    const { createHash } = await import('crypto');
-    const hash = createHash('sha256').update(verifier).digest();
+    const { createHash } = await import("node:crypto");
+    const hash = createHash("sha256").update(verifier).digest();
     return base64UrlEncode(hash);
 }
 /**
@@ -103,9 +106,9 @@ function generateState() {
  */
 function base64UrlEncode(buffer) {
     return buffer
-        .toString('base64')
-        .replace(/\+/g, '-')
-        .replace(/\//g, '_')
-        .replace(/=/g, '');
+        .toString("base64")
+        .replace(/\+/g, "-")
+        .replace(/\//g, "_")
+        .replace(/=/g, "");
 }
 //# sourceMappingURL=oauth-flow.js.map

package/dist/utils/project-discovery.d.ts

@@ -13,13 +13,13 @@ export interface DotreqProject {
  * Result of project discovery - either a single project or multiple projects
  */
 export type ProjectDiscoveryResult = {
-    type: 'none';
+    type: "none";
     message: string;
 } | {
-    type: 'single';
+    type: "single";
     project: DotreqProject;
 } | {
-    type: 'multiple';
+    type: "multiple";
     projects: DotreqProject[];
 };
 /**

package/dist/utils/project-discovery.js

@@ -1,15 +1,16 @@
-import * as fs from 'fs';
-import * as path from 'path';
-import { glob } from 'glob';
-import { readProjectSettings } from './project-settings.js';
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { glob } from "glob";
+import { readProjectSettings, } from "./project-settings.js";
 /**
  * Check if a directory is a configured dotrequirements project
  * A project is configured if it has .requirements/project-settings.json with credentials
  */
 export function isConfiguredProject(dir) {
-    const requirementsDir = path.join(dir, '.requirements');
+    const requirementsDir = path.join(dir, ".requirements");
     // Check for .requirements/ directory
-    if (!fs.existsSync(requirementsDir) || !fs.statSync(requirementsDir).isDirectory()) {
+    if (!fs.existsSync(requirementsDir) ||
+        !fs.statSync(requirementsDir).isDirectory()) {
         return null;
     }
     // Try to read credentials from project-settings.json
@@ -38,10 +39,10 @@ export function isConfiguredProject(dir) {
 export async function findConfiguredProjects(startDir) {
     const projects = [];
     // Find all .requirements directories
-    const requirementsDirs = await glob('**/.requirements', {
+    const requirementsDirs = await glob("**/.requirements", {
         cwd: startDir,
         absolute: true,
-        ignore: ['**/node_modules/**', '**/dist/**', '**/.git/**', '**/build/**'],
+        ignore: ["**/node_modules/**", "**/dist/**", "**/.git/**", "**/build/**"],
     });
     for (const reqDir of requirementsDirs) {
         const dir = path.dirname(reqDir);
@@ -64,23 +65,23 @@ export async function discoverProjects(workingDir = process.cwd()) {
     // Case 2: Check if working directory itself is configured
     const selfProject = isConfiguredProject(workingDir);
     if (selfProject) {
-        return { type: 'single', project: selfProject };
+        return { type: "single", project: selfProject };
     }
     // Find all configured projects in descendants
     const childProjects = await findConfiguredProjects(workingDir);
     // Case 1: No projects found
     if (childProjects.length === 0) {
         return {
-            type: 'none',
+            type: "none",
             message: `No dotrequirements projects found in ${workingDir} or its children.\n\nA project must have:\n1. A .requirements/ directory\n2. Cloud credentials in .requirements/project-settings.json\n\nRun "dotrequirements init" to create a project or "dotrequirements link" to connect to cloud.`,
         };
     }
     // Case 3: Exactly one child project
     if (childProjects.length === 1) {
-        return { type: 'single', project: childProjects[0] };
+        return { type: "single", project: childProjects[0] };
     }
     // Case 4: Multiple child projects
-    return { type: 'multiple', projects: childProjects };
+    return { type: "multiple", projects: childProjects };
 }
 /**
  * Resolve a single project from discovery result
@@ -88,10 +89,10 @@ export async function discoverProjects(workingDir = process.cwd()) {
  * Otherwise returns the single project or throws an error
  */
 export function resolveProject(result, projectId) {
-    if (result.type === 'none') {
+    if (result.type === "none") {
         throw new Error(result.message);
     }
-    if (result.type === 'single') {
+    if (result.type === "single") {
         return result.project;
     }
     // Multiple projects case
@@ -99,14 +100,14 @@ export function resolveProject(result, projectId) {
         const projectList = result.projects
             .map((p) => {
             const relativePath = path.relative(process.cwd(), p.path);
-            return `  - ${relativePath || '.'}: ${p.projectId}`;
+            return `  - ${relativePath || "."}: ${p.projectId}`;
         })
-            .join('\n');
+            .join("\n");
         throw new Error(`Multiple dotrequirements projects found. Please specify projectId parameter:\n\n${projectList}`);
     }
     const project = result.projects.find((p) => p.projectId === projectId);
     if (!project) {
-        const availableIds = result.projects.map((p) => p.projectId).join(', ');
+        const availableIds = result.projects.map((p) => p.projectId).join(", ");
         throw new Error(`Project "${projectId}" not found. Available projects: ${availableIds}`);
     }
     return project;

package/dist/utils/project-name.js

@@ -1,6 +1,6 @@
-import * as fs from 'fs';
-import * as path from 'path';
-import * as readline from 'readline';
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as readline from "node:readline";
 /**
  * Detect project name from various sources
  * Priority: --name flag > package.json > directory name > user prompt
@@ -12,8 +12,8 @@ export async function detectProjectName(options) {
     }
     // 2. Try package.json
     try {
-        const pkgPath = path.join(process.cwd(), 'package.json');
-        const pkgContent = fs.readFileSync(pkgPath, 'utf-8');
+        const pkgPath = path.join(process.cwd(), "package.json");
+        const pkgContent = fs.readFileSync(pkgPath, "utf-8");
         const pkg = JSON.parse(pkgContent);
         if (pkg.name) {
             return pkg.name;
@@ -24,7 +24,7 @@ export async function detectProjectName(options) {
     }
     // 3. Use directory name
     const dirName = path.basename(process.cwd());
-    if (dirName && dirName !== '/' && dirName !== '.') {
+    if (dirName && dirName !== "/" && dirName !== ".") {
         return dirName;
     }
     // 4. Fallback to user prompt
@@ -39,9 +39,9 @@ async function promptForProjectName() {
         output: process.stdout,
     });
     return new Promise((resolve) => {
-        rl.question('Project name: ', (answer) => {
+        rl.question("Project name: ", (answer) => {
             rl.close();
-            resolve(answer.trim() || 'my-project');
+            resolve(answer.trim() || "my-project");
         });
     });
 }

package/dist/utils/project-selector.d.ts

@@ -1,4 +1,4 @@
-import { ConvexHttpClient } from 'convex/browser';
+import type { ConvexHttpClient } from "convex/browser";
 export interface SelectedProject {
     projectId: string;
     projectName: string;

package/dist/utils/project-selector.js

@@ -1,36 +1,36 @@
-import { promptChoice } from './prompts.js';
-import { api } from '../convex.js';
+import { api } from "../convex.js";
+import { promptChoice } from "./prompts.js";
 /**
  * Prompt user to select a team from their available teams.
  * Returns the team ID and tier, or null if user cancels.
  */
 export async function selectTeam(client) {
-    console.log('Fetching your teams...\n');
+    console.log("Fetching your teams...\n");
     // AUTH-24.0: Ensure user has a default team if they don't have any
     await client.mutation(api.teams.mutations.ensureDefaultTeam, {});
-    const teams = await client.query(api.teams.queries.listForUserWithUsage);
+    const teams = (await client.query(api.teams.queries.listForUserWithUsage));
     if (teams.length === 0) {
-        console.log('You are not a member of any teams.');
-        console.log('To create a team, visit: https://app.dotrequirements.io/teams/new\n');
+        console.log("You are not a member of any teams.");
+        console.log("To create a team, visit: https://app.dotrequirements.io/teams/new\n");
         return null;
     }
     const teamChoices = teams.map((team) => {
         const limitDisplay = team.projectLimit === -1
-            ? 'unlimited'
+            ? "unlimited"
             : `${team.projectCount}/${team.projectLimit}`;
         return {
             title: `${team.name} (${team.tierName} - ${limitDisplay} projects)`,
             value: team.teamId,
         };
     });
-    const selectedTeamId = await promptChoice('Select a team:', teamChoices);
+    const selectedTeamId = await promptChoice("Select a team:", teamChoices);
     if (!selectedTeamId) {
         return null;
     }
     const selectedTeam = teams.find((t) => t.teamId === selectedTeamId);
     return {
         teamId: selectedTeamId,
-        tier: selectedTeam?.tier ?? 'free',
+        tier: selectedTeam?.tier ?? "free",
     };
 }
 /**
@@ -38,10 +38,12 @@ export async function selectTeam(client) {
  * Returns the selected project info, or null if user cancels or no projects exist.
  */
 export async function selectProject(client, teamId) {
-    console.log('\nFetching projects...\n');
-    const projectsWithSecrets = await client.query(api.projectSecrets.queries.listOwnSecretsForTeam, { target: { type: 'team', id: teamId } });
+    console.log("\nFetching projects...\n");
+    const projectsWithSecrets = (await client.query(api.projectSecrets.queries.listOwnSecretsForTeam, 
+    // biome-ignore lint/suspicious/noExplicitAny: CLI workspace doesn't import convex's branded Id<"teams"> type; the runtime value is a plain string the convex server validates.
+    { target: { type: "team", id: teamId } }));
     if (projectsWithSecrets.length === 0) {
-        console.log('No projects found in this team.');
+        console.log("No projects found in this team.");
         console.log('Use "dotrequirements init" to create a new project.\n');
         return null;
     }
@@ -51,7 +53,7 @@ export async function selectProject(client, teamId) {
             : project.projectName,
         value: project.projectId,
     }));
-    const selectedProjectId = await promptChoice('Select a project:', projectChoices);
+    const selectedProjectId = await promptChoice("Select a project:", projectChoices);
     if (!selectedProjectId) {
         return null;
     }
@@ -73,10 +75,11 @@ export async function selectProject(client, teamId) {
  *                     Free tier always gets 30 days regardless of this parameter.
  */
 export async function getOrCreateProjectSecret(client, projectId, expiryDays) {
-    const result = await client.mutation(api.projectSecrets.mutations.ensureOwnSecret, {
-        target: { type: 'project', id: projectId },
+    const result = (await client.mutation(api.projectSecrets.mutations.ensureOwnSecret, {
+        // biome-ignore lint/suspicious/noExplicitAny: CLI workspace doesn't import convex's branded Id<"projects"> type; the runtime value is a plain string the convex server validates.
+        target: { type: "project", id: projectId },
         expiryDays,
-    });
+    }));
     return result;
 }
 /**
@@ -85,14 +88,14 @@ export async function getOrCreateProjectSecret(client, projectId, expiryDays) {
  */
 export async function promptExpiryDays(tierSlug) {
     // Free tier users don't get a choice - always 30 days
-    if (tierSlug === 'free') {
+    if (tierSlug === "free") {
         return undefined;
     }
     // AUTHZ-3.1, AUTHZ-3.2: Paid tier users can choose expiry
-    const choice = await promptChoice('How long should this secret be valid?', [
-        { title: '365 days (Recommended)', value: '365' },
-        { title: '90 days', value: '90' },
-        { title: '30 days', value: '30' },
+    const choice = await promptChoice("How long should this secret be valid?", [
+        { title: "365 days (Recommended)", value: "365" },
+        { title: "90 days", value: "90" },
+        { title: "30 days", value: "30" },
     ]);
     // If user cancels, use default (365 for paid tier)
     if (!choice) {

package/dist/utils/project-settings.d.ts

@@ -1,7 +1,8 @@
-/**
- * Browser test configuration
- */
+/** Browser test configuration. */
 export interface BrowserTestSettings {
+    modelName?: string;
+    modelApiKey?: string;
+    /** @deprecated Backward-compat fallback; use modelName + modelApiKey instead. */
     geminiApiKey?: string;
     vercelBypassSecret?: string;
     browserbaseApiKey?: string;
@@ -19,7 +20,7 @@ export interface ProjectSettings {
 /**
  * Project status indicating whether it's connected to cloud
  */
-export type ProjectStatus = 'cloud-connected' | 'local-only';
+export type ProjectStatus = "cloud-connected" | "local-only";
 /**
  * Result of finding a project
  */