usertester 0.1.0

package/dist/cli/setup.js

@@ -0,0 +1,168 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import readline from 'node:readline';
+function prompt(rl, question) {
+    return new Promise(resolve => rl.question(question, resolve));
+}
+async function validateOpenRouterKey(apiKey) {
+    try {
+        const { createOpenRouter } = await import('@openrouter/ai-sdk-provider');
+        const { generateText } = await import('ai');
+        const or = createOpenRouter({ apiKey });
+        await generateText({
+            model: or('anthropic/claude-haiku-4-5'),
+            messages: [{ role: 'user', content: 'hi' }],
+            maxOutputTokens: 5,
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function validateAnthropicKey(apiKey) {
+    try {
+        const { createAnthropic } = await import('@ai-sdk/anthropic');
+        const { generateText } = await import('ai');
+        const provider = createAnthropic({ apiKey });
+        await generateText({
+            model: provider('claude-haiku-4-5-20251001'),
+            messages: [{ role: 'user', content: 'hi' }],
+            maxOutputTokens: 5,
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function validateAgentMailKey(apiKey) {
+    try {
+        const { AgentMailClient } = await import('agentmail');
+        const client = new AgentMailClient({ apiKey });
+        await client.inboxes.list();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function registerSetup(program) {
+    program
+        .command('setup')
+        .description('Interactive first-run setup — configure API keys and validate')
+        .option('--force', 'Overwrite existing .env', false)
+        .action(async (opts) => {
+        const envPath = path.join(process.cwd(), '.env');
+        if (fs.existsSync(envPath) && !opts.force) {
+            console.log(`.env already exists at ${envPath}`);
+            console.log('Run with --force to overwrite, or edit it directly.');
+            process.exit(0);
+        }
+        console.log('usertester setup\n');
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        const envLines = [];
+        // --- LLM provider choice ---
+        console.log('Choose your LLM provider:');
+        console.log('  OpenRouter gives you one API key that covers Anthropic + OpenAI models.');
+        console.log('  Alternatively you can configure Anthropic and/or OpenAI directly.\n');
+        const useOpenRouter = (await prompt(rl, 'Use OpenRouter? (single API key, covers Anthropic + OpenAI) [Y/n]: ')).trim();
+        const preferOpenRouter = !useOpenRouter || useOpenRouter.toLowerCase() !== 'n';
+        if (preferOpenRouter) {
+            console.log('\nGet your key at: https://openrouter.ai/keys\n');
+            let openrouterKey = '';
+            while (true) {
+                openrouterKey = (await prompt(rl, 'OpenRouter API key (sk-or-...): ')).trim();
+                if (!openrouterKey) {
+                    console.log('Key cannot be empty.');
+                    continue;
+                }
+                process.stdout.write('  Validating... ');
+                const valid = await validateOpenRouterKey(openrouterKey);
+                if (valid) {
+                    console.log('ok');
+                    break;
+                }
+                else {
+                    console.log('Invalid — check the key and try again.');
+                }
+            }
+            envLines.push(`OPENROUTER_API_KEY=${openrouterKey}`);
+        }
+        else {
+            // Direct Anthropic
+            console.log('\nGet your Anthropic key at: https://console.anthropic.com/settings/keys\n');
+            let anthropicKey = '';
+            while (true) {
+                anthropicKey = (await prompt(rl, 'Anthropic API key (sk-ant-...): ')).trim();
+                if (!anthropicKey) {
+                    console.log('Key cannot be empty.');
+                    continue;
+                }
+                process.stdout.write('  Validating... ');
+                const valid = await validateAnthropicKey(anthropicKey);
+                if (valid) {
+                    console.log('ok');
+                    break;
+                }
+                else {
+                    console.log('Invalid — check the key and try again.');
+                }
+            }
+            envLines.push(`ANTHROPIC_API_KEY=${anthropicKey}`);
+            // Optional OpenAI
+            const addOpenAI = (await prompt(rl, 'Also configure OpenAI API key? [y/N]: ')).trim();
+            if (addOpenAI.toLowerCase() === 'y') {
+                console.log('\nGet your key at: https://platform.openai.com/api-keys\n');
+                let openaiKey = '';
+                while (true) {
+                    openaiKey = (await prompt(rl, 'OpenAI API key (sk-...): ')).trim();
+                    if (!openaiKey) {
+                        console.log('Key cannot be empty.');
+                        continue;
+                    }
+                    process.stdout.write('  Validating... ');
+                    // Basic format check (full validation requires a call)
+                    if (openaiKey.startsWith('sk-')) {
+                        console.log('ok (format check)');
+                        break;
+                    }
+                    else {
+                        console.log('Key should start with sk-');
+                    }
+                }
+                envLines.push(`OPENAI_API_KEY=${openaiKey}`);
+            }
+        }
+        // --- AgentMail ---
+        console.log('\nGet your AgentMail key at: https://agentmail.to/dashboard\n');
+        let agentmailKey = '';
+        while (true) {
+            agentmailKey = (await prompt(rl, 'AgentMail API key: ')).trim();
+            if (!agentmailKey) {
+                console.log('Key cannot be empty.');
+                continue;
+            }
+            process.stdout.write('  Validating... ');
+            const valid = await validateAgentMailKey(agentmailKey);
+            if (valid) {
+                console.log('ok');
+                break;
+            }
+            else {
+                console.log('Invalid — check the key and try again.');
+            }
+        }
+        envLines.push(`AGENTMAIL_API_KEY=${agentmailKey}`);
+        rl.close();
+        const envContent = envLines.join('\n') + '\n';
+        fs.writeFileSync(envPath, envContent);
+        console.log(`\nWritten to ${envPath}`);
+        console.log('\nYou\'re ready. Try:');
+        console.log('  usertester spawn --url https://yourapp.com --n 1 --message "Sign up as a new user"');
+    });
+}
+//# sourceMappingURL=setup.js.map

package/dist/cli/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":"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"}

package/dist/cli/spawn.d.ts

@@ -0,0 +1,5 @@
+/**
+ * usertester spawn — launch N agents against a URL
+ */
+import type { Command } from 'commander';
+export declare function registerSpawn(program: Command): void;

package/dist/cli/spawn.js

@@ -0,0 +1,52 @@
+import fs from 'node:fs';
+import { DEFAULT_CONFIG } from '../types.js';
+import { orchestrate } from '../orchestrator/index.js';
+export function registerSpawn(program) {
+    program
+        .command('spawn')
+        .description('Spawn N AI agents as simulated users against a URL')
+        .requiredOption('--url <url>', 'Target URL')
+        .option('-n, --n <number>', 'Number of agents', '1')
+        .option('--message <message>', 'Task message for all agents')
+        .option('--messages-file <file>', 'JSON file with per-agent messages')
+        .option('--session <id>', 'Resume an existing session ID')
+        .action(async (opts) => {
+        const config = { ...DEFAULT_CONFIG };
+        // Resolve messages
+        let messages = [];
+        if (opts.messagesFile) {
+            try {
+                const raw = JSON.parse(fs.readFileSync(opts.messagesFile, 'utf-8'));
+                messages = raw.map(r => r.message);
+            }
+            catch (err) {
+                console.error(`Error reading messages file: ${err}`);
+                process.exit(1);
+            }
+        }
+        else if (opts.message) {
+            messages = [opts.message];
+        }
+        else {
+            console.error('Error: --message or --messages-file is required');
+            process.exit(1);
+        }
+        const n = parseInt(opts.n, 10);
+        if (isNaN(n) || n < 1) {
+            console.error('Error: --n must be a positive integer');
+            process.exit(1);
+        }
+        if (!config.agentmail_api_key) {
+            console.error('Error: AGENTMAIL_API_KEY is not set');
+            process.exit(1);
+        }
+        if (!config.anthropic_api_key) {
+            console.error('Error: ANTHROPIC_API_KEY is not set');
+            process.exit(1);
+        }
+        // Ensure results dir exists
+        fs.mkdirSync(config.results_dir, { recursive: true });
+        await orchestrate({ url: opts.url, messages, n, config });
+    });
+}
+//# sourceMappingURL=spawn.js.map

package/dist/cli/spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.js","sourceRoot":"","sources":["../../src/cli/spawn.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAEtD,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,oDAAoD,CAAC;SACjE,cAAc,CAAC,aAAa,EAAE,YAAY,CAAC;SAC3C,MAAM,CAAC,kBAAkB,EAAE,kBAAkB,EAAE,GAAG,CAAC;SACnD,MAAM,CAAC,qBAAqB,EAAE,6BAA6B,CAAC;SAC5D,MAAM,CAAC,wBAAwB,EAAE,mCAAmC,CAAC;SACrE,MAAM,CAAC,gBAAgB,EAAE,+BAA+B,CAAC;SACzD,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,CAAA;QAEpC,mBAAmB;QACnB,IAAI,QAAQ,GAAa,EAAE,CAAA;QAC3B,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAA+B,CAAA;gBACjG,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;YACpC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,gCAAgC,GAAG,EAAE,CAAC,CAAA;gBACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACjB,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACxB,QAAQ,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC3B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAA;YAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;QAED,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QAC9B,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAA;YACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAC9B,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAA;YACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAC9B,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAA;YACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;QAED,4BAA4B;QAC5B,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAErD,MAAM,WAAW,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;IAC3D,CAAC,CAAC,CAAA;AACN,CAAC"}

package/dist/cli/status.d.ts

@@ -0,0 +1,5 @@
+/**
+ * usertester status — print current session agent states
+ */
+import type { Command } from 'commander';
+export declare function registerStatus(program: Command): void;

package/dist/cli/status.js

@@ -0,0 +1,85 @@
+import path from 'node:path';
+import fs from 'node:fs';
+import { DEFAULT_CONFIG } from '../types.js';
+import { loadSession } from '../orchestrator/session.js';
+const STATUS_COLORS = {
+    QUEUED: '\x1b[90m', // gray
+    SPAWNING: '\x1b[33m', // yellow
+    INBOX_READY: '\x1b[33m', // yellow
+    SIGNING_UP: '\x1b[36m', // cyan
+    RUNNING: '\x1b[36m', // cyan
+    WAITING: '\x1b[32m', // green
+    DONE: '\x1b[90m', // gray
+    FAILED: '\x1b[31m', // red
+    CANCELLED: '\x1b[90m', // gray
+};
+const RESET = '\x1b[0m';
+function elapsedStr(ms) {
+    const s = Math.floor(ms / 1000);
+    if (s < 60)
+        return `${s}s`;
+    const m = Math.floor(s / 60);
+    return `${m}m ${s % 60}s`;
+}
+function colorStatus(status) {
+    const color = STATUS_COLORS[status] ?? '';
+    return `${color}${status}${RESET}`;
+}
+export function registerStatus(program) {
+    program
+        .command('status')
+        .description('Show status of all agents in the current session')
+        .option('--session <id>', 'Session ID (defaults to current)')
+        .option('--json', 'Output raw JSON')
+        .action((opts) => {
+        const config = { ...DEFAULT_CONFIG };
+        let sessionId = opts.session;
+        if (!sessionId) {
+            const currentLink = path.join(config.results_dir, 'current');
+            try {
+                const target = fs.readlinkSync(currentLink);
+                sessionId = path.basename(target);
+            }
+            catch {
+                console.error('No active session found. Run `usertester spawn` first.');
+                process.exit(1);
+            }
+        }
+        const state = loadSession(config.results_dir, sessionId);
+        if (!state) {
+            console.error(`Session ${sessionId} not found`);
+            process.exit(1);
+        }
+        if (opts.json) {
+            console.log(JSON.stringify(state, null, 2));
+            return;
+        }
+        const now = Date.now();
+        console.log(`Session: ${state.sessionId}`);
+        console.log(`URL:     ${state.url}`);
+        console.log(`Started: ${new Date(state.startedAt).toLocaleTimeString()}`);
+        console.log();
+        console.log('AGENT         STATUS        ELAPSED   INBOX');
+        console.log('─'.repeat(70));
+        for (const agent of state.agents) {
+            const elapsed = agent.startedAt ? elapsedStr(now - agent.startedAt) : '-';
+            const inbox = agent.inboxId ? agent.inboxId.split('@')[0] + '@...' : '-';
+            const status = colorStatus(agent.status);
+            const msg = agent.currentMessage ? `  "${agent.currentMessage.slice(0, 30)}"` : '';
+            console.log(`${agent.id.padEnd(14)}${status.padEnd(22)}${elapsed.padEnd(10)}${inbox}${msg}`);
+            if (agent.error) {
+                console.log(`  Error: ${agent.error}`);
+            }
+        }
+        const summary = {
+            total: state.agents.length,
+            running: state.agents.filter(a => a.status === 'RUNNING').length,
+            waiting: state.agents.filter(a => a.status === 'WAITING').length,
+            failed: state.agents.filter(a => a.status === 'FAILED').length,
+            done: state.agents.filter(a => ['DONE', 'CANCELLED'].includes(a.status)).length,
+        };
+        console.log();
+        console.log(`${summary.running} running, ${summary.waiting} waiting, ${summary.failed} failed, ${summary.done} done`);
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/cli/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/cli/status.ts"],"names":[],"mappings":"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"}

package/dist/harness/applier.d.ts

@@ -0,0 +1,38 @@
+import type { CodePatch } from './proposer.js';
+export interface PatchRecord {
+    patchId: string;
+    appliedAt: string;
+    triggerSessionId: string;
+    patternType: string;
+    file: string;
+    before: string;
+    after: string;
+    description: string;
+}
+export declare function applyPatch(patch: CodePatch, triggerSessionId: string, harnessDir: string, projectRoot: string): Promise<{
+    applied: boolean;
+    patchId?: string;
+    error?: string;
+}>;
+/**
+ * Read a patch record by ID.
+ */
+export declare function readPatchRecord(harnessDir: string, patchId: string): PatchRecord | null;
+/**
+ * List all patch records sorted by patchId ascending.
+ */
+export declare function listPatchRecords(harnessDir: string): PatchRecord[];
+/**
+ * Rollback a patch by writing the `before` contents back to the source file.
+ */
+export declare function rollbackPatch(patchId: string, harnessDir: string, projectRoot: string): Promise<{
+    rolledBack: boolean;
+    error?: string;
+}>;
+/**
+ * Write a rollback using the temp file approach for atomicity.
+ */
+export declare function rollbackPatchAtomic(patchId: string, harnessDir: string, projectRoot: string): Promise<{
+    rolledBack: boolean;
+    error?: string;
+}>;

package/dist/harness/applier.js

@@ -0,0 +1,152 @@
+/**
+ * Atomically applies a validated code patch and records a PatchRecord.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+export async function applyPatch(patch, triggerSessionId, harnessDir, projectRoot) {
+    // Step 1: Determine next patchId
+    const patchesDir = path.join(harnessDir, 'patches');
+    fs.mkdirSync(patchesDir, { recursive: true });
+    let nextN = 1;
+    try {
+        const existing = fs.readdirSync(patchesDir)
+            .filter(f => f.endsWith('.json'))
+            .map(f => {
+            const match = f.match(/patch_(\d+)\.json/);
+            return match ? parseInt(match[1], 10) : 0;
+        });
+        if (existing.length > 0) {
+            nextN = Math.max(...existing) + 1;
+        }
+    }
+    catch { }
+    const patchId = `patch_${String(nextN).padStart(3, '0')}`;
+    // Step 2: Read source file
+    const absoluteFilePath = path.join(projectRoot, patch.file);
+    let before;
+    try {
+        before = fs.readFileSync(absoluteFilePath, 'utf-8');
+    }
+    catch (err) {
+        return { applied: false, error: `Cannot read ${patch.file}: ${err}` };
+    }
+    // Step 3: Verify oldCode appears exactly once (double-check)
+    const occurrences = before.split(patch.oldCode).length - 1;
+    if (occurrences !== 1) {
+        return {
+            applied: false,
+            error: `oldCode appears ${occurrences} times in ${patch.file} (expected exactly 1)`,
+        };
+    }
+    // Step 4: Build new contents
+    const after = before.replace(patch.oldCode, patch.newCode);
+    // Step 5: Write PatchRecord FIRST (atomic)
+    const record = {
+        patchId,
+        appliedAt: new Date().toISOString(),
+        triggerSessionId,
+        patternType: patch.patternType,
+        file: patch.file,
+        before,
+        after,
+        description: patch.description,
+    };
+    const recordPath = path.join(patchesDir, `${patchId}.json`);
+    try {
+        fs.writeFileSync(recordPath, JSON.stringify(record, null, 2), 'utf-8');
+    }
+    catch (err) {
+        return { applied: false, error: `Cannot write patch record: ${err}` };
+    }
+    // Step 6: Write new source file atomically (.tmp then rename)
+    const tmpPath = absoluteFilePath + `.${patchId}.tmp`;
+    try {
+        fs.writeFileSync(tmpPath, after, 'utf-8');
+        fs.renameSync(tmpPath, absoluteFilePath);
+    }
+    catch (err) {
+        // Clean up tmp if rename failed
+        try {
+            fs.unlinkSync(tmpPath);
+        }
+        catch { }
+        return { applied: false, error: `Cannot write patched file: ${err}` };
+    }
+    // Step 7: Append to applier.log
+    const logLine = `[${record.appliedAt}] ${patchId} applied to ${patch.file}: ${patch.description} (session: ${triggerSessionId})\n`;
+    try {
+        fs.appendFileSync(path.join(harnessDir, 'applier.log'), logLine);
+    }
+    catch { }
+    return { applied: true, patchId };
+}
+/**
+ * Read a patch record by ID.
+ */
+export function readPatchRecord(harnessDir, patchId) {
+    const recordPath = path.join(harnessDir, 'patches', `${patchId}.json`);
+    try {
+        const content = fs.readFileSync(recordPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * List all patch records sorted by patchId ascending.
+ */
+export function listPatchRecords(harnessDir) {
+    const patchesDir = path.join(harnessDir, 'patches');
+    try {
+        const files = fs.readdirSync(patchesDir)
+            .filter(f => f.endsWith('.json'))
+            .sort();
+        return files.map(f => {
+            try {
+                return JSON.parse(fs.readFileSync(path.join(patchesDir, f), 'utf-8'));
+            }
+            catch {
+                return null;
+            }
+        }).filter((r) => r !== null);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Rollback a patch by writing the `before` contents back to the source file.
+ */
+export async function rollbackPatch(patchId, harnessDir, projectRoot) {
+    const record = readPatchRecord(harnessDir, patchId);
+    if (!record) {
+        return { rolledBack: false, error: `Patch record not found: ${patchId}` };
+    }
+    const absoluteFilePath = path.join(projectRoot, record.file);
+    const tmpPath = absoluteFilePath + `.rollback-${patchId}.tmp`;
+    try {
+        fs.writeFileSync(tmpPath, record.before, 'utf-8');
+        fs.renameSync(tmpPath, absoluteFilePath);
+    }
+    catch (err) {
+        try {
+            fs.unlinkSync(tmpPath);
+        }
+        catch { }
+        return { rolledBack: false, error: `Cannot write rollback: ${err}` };
+    }
+    const logLine = `[${new Date().toISOString()}] ROLLBACK ${patchId} (file: ${record.file})\n`;
+    try {
+        fs.appendFileSync(path.join(harnessDir, 'applier.log'), logLine);
+    }
+    catch { }
+    return { rolledBack: true };
+}
+/**
+ * Write a rollback using the temp file approach for atomicity.
+ */
+export async function rollbackPatchAtomic(patchId, harnessDir, projectRoot) {
+    return rollbackPatch(patchId, harnessDir, projectRoot);
+}
+//# sourceMappingURL=applier.js.map

package/dist/harness/applier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"applier.js","sourceRoot":"","sources":["../../src/harness/applier.ts"],"names":[],"mappings":"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"}

package/dist/harness/index.d.ts

@@ -0,0 +1,14 @@
+import type { UsertesterConfig } from '../types.js';
+import type { RetryAttempt } from '../orchestrator/retry.js';
+export declare function runHarnessLoop(opts: {
+    sessionId: string;
+    agentRetryHistories: RetryAttempt[][];
+    agentToolsUsed: string[][];
+    agentProfileHits: boolean[];
+    agentSucceeded: boolean[];
+    url: string;
+    nAgents: number;
+    config: Partial<UsertesterConfig>;
+    harnessDir: string;
+    projectRoot: string;
+}): Promise<void>;