@tangle-network/browser-agent-driver 0.12.1 → 0.14.0

package/dist/cli-view.js

@@ -0,0 +1,397 @@
+/**
+ * CLI handler for `bad view <run-dir>`.
+ *
+ * Spins up a tiny static HTTP server in front of the run's artifact
+ * directory and opens the viewer in the user's default browser.
+ *
+ * No build pipeline, no React, no separate package — viewer.html is a
+ * single self-contained file shipped in the package and copied to dist
+ * at build time by `scripts/copy-static-assets.mjs`.
+ *
+ * Library-friendly: this module throws typed errors instead of calling
+ * `process.exit`. The CLI dispatcher catches and exits.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as http from 'node:http';
+import { fileURLToPath } from 'node:url';
+import { spawn } from 'node:child_process';
+import chalk from 'chalk';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+/** Resolved at module load — single canonical path, no runtime probing. */
+const VIEWER_HTML_PATH = (() => {
+    // Production: dist/cli-view.js + dist/viewer/viewer.html
+    const distPath = path.join(__dirname, 'viewer/viewer.html');
+    if (fs.existsSync(distPath))
+        return distPath;
+    // Source dev mode: src/cli-view.ts + src/viewer/viewer.html
+    const srcPath = path.join(__dirname, '../viewer/viewer.html');
+    if (fs.existsSync(srcPath))
+        return srcPath;
+    // Last-resort: walking up one more level (for unusual layouts)
+    const upPath = path.join(__dirname, '../../src/viewer/viewer.html');
+    if (fs.existsSync(upPath))
+        return upPath;
+    return '';
+})();
+export class ViewError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ViewError';
+    }
+}
+/**
+ * Resolves a `report.json` file inside a run directory. Searches the
+ * run directory itself first, then one level deep.
+ */
+export function findReportJson(runDir) {
+    const direct = path.join(runDir, 'report.json');
+    if (fs.existsSync(direct))
+        return direct;
+    try {
+        for (const entry of fs.readdirSync(runDir, { withFileTypes: true })) {
+            if (entry.isDirectory()) {
+                const sub = path.join(runDir, entry.name, 'report.json');
+                if (fs.existsSync(sub))
+                    return sub;
+            }
+        }
+    }
+    catch {
+        /* ignore unreadable dir */
+    }
+    return null;
+}
+/**
+ * Find all recording.webm files anywhere under the report root (one level
+ * deep — agent runs put them in `<run>/<test-id>/recording.webm`). Returns
+ * an array of `{ testId, relPath }` so the viewer can show one player per
+ * test case in a multi-test suite run.
+ *
+ * Skips 0-byte files (Playwright sometimes writes the path before flushing
+ * the video on context close, leaving an empty placeholder) — the viewer
+ * will fall back to per-turn screenshots when no usable recording exists.
+ */
+export function findRecordings(reportRoot) {
+    const out = [];
+    const isUsableRecording = (filePath) => {
+        try {
+            const stats = fs.statSync(filePath);
+            return stats.isFile() && stats.size > 0;
+        }
+        catch {
+            return false;
+        }
+    };
+    try {
+        for (const entry of fs.readdirSync(reportRoot, { withFileTypes: true })) {
+            if (entry.isDirectory()) {
+                const recording = path.join(reportRoot, entry.name, 'recording.webm');
+                if (isUsableRecording(recording)) {
+                    out.push({ testId: entry.name, relPath: `${entry.name}/recording.webm` });
+                }
+            }
+            else if (entry.name === 'recording.webm') {
+                const recording = path.join(reportRoot, entry.name);
+                if (isUsableRecording(recording)) {
+                    out.push({ testId: 'default', relPath: 'recording.webm' });
+                }
+            }
+        }
+    }
+    catch {
+        /* ignore */
+    }
+    return out;
+}
+/**
+ * Normalize the report shape so the viewer sees a consistent format.
+ *
+ * Two distinct shapes flow through here:
+ *   - **Design audit** (cli-design-audit.ts): top-level `pages[]`, each
+ *     with screenshot file paths and findings. Native shape — passed through.
+ *   - **Agent run** (test-runner.ts → FilesystemSink): top-level
+ *     `results[].agentResult.turns[]` where each turn has `state.screenshot`
+ *     as a raw base64 string. Unwrapped to a normalized `{ tests[]: { ...,
+ *     turns[] } }` shape with screenshots converted to data URLs.
+ *
+ * Recordings discovered on disk are attached to the matching test by id.
+ */
+export function normalizeReport(raw, recordings) {
+    const data = raw;
+    if (!data || typeof data !== 'object')
+        return { error: 'invalid report' };
+    // Design audit shape — has top-level `pages[]`. Pass through.
+    if (Array.isArray(data.pages)) {
+        return data;
+    }
+    // Agent run shape — has top-level `results[]` with `.agentResult.turns[]`.
+    if (Array.isArray(data.results)) {
+        const results = data.results;
+        const tests = results.map(r => {
+            const agentResult = (r.agentResult ?? {});
+            const turns = (agentResult.turns ?? []).map(t => {
+                const state = (t.state ?? {});
+                const screenshot = state.screenshot;
+                // Convert raw base64 → data URL so the <img> tag renders it.
+                // NOTE: JPEG base64 starts with `/9j/` (first byte 0xFF), so the
+                // leading slash is NOT a path indicator. Detect format properly:
+                //   - already a data: URL → leave it
+                //   - absolute file path or http(s) URL → leave it (legacy on-disk runs)
+                //   - everything else → assume base64, prefix as JPEG data URL
+                const screenshotDataUrl = !screenshot
+                    ? screenshot
+                    : screenshot.startsWith('data:')
+                        ? screenshot
+                        : screenshot.startsWith('http://') || screenshot.startsWith('https://')
+                            ? screenshot
+                            : screenshot.startsWith('/') && (screenshot.endsWith('.png') || screenshot.endsWith('.jpg') || screenshot.endsWith('.jpeg') || screenshot.endsWith('.webp'))
+                                ? screenshot
+                                : `data:image/jpeg;base64,${screenshot}`;
+                return {
+                    ...t,
+                    state: { ...state, screenshot: screenshotDataUrl },
+                };
+            });
+            const testCase = (r.testCase ?? {});
+            const testId = (testCase.id ?? testCase.name ?? 'cli-task');
+            const recording = recordings.find(rec => rec.testId === testId)
+                ?? recordings.find(rec => rec.testId === 'default');
+            return {
+                id: testId,
+                name: testCase.name ?? testId,
+                success: agentResult.success ?? r.agentSuccess,
+                verdict: r.verdict,
+                turnsUsed: r.turnsUsed,
+                durationMs: r.durationMs,
+                estimatedCostUsd: r.estimatedCostUsd,
+                recording: recording ? recording.relPath : null,
+                turns,
+            };
+        });
+        return {
+            ...data,
+            // Both fields present so existing readers still work; the viewer
+            // prefers `tests[]` for agent runs.
+            tests,
+        };
+    }
+    // Single agent result shape (no suite wrapper) — `turns[]` directly.
+    if (Array.isArray(data.turns)) {
+        const turns = (data.turns).map(t => {
+            const state = (t.state ?? {});
+            const screenshot = state.screenshot;
+            const screenshotDataUrl = !screenshot
+                ? screenshot
+                : screenshot.startsWith('data:')
+                    ? screenshot
+                    : screenshot.startsWith('http://') || screenshot.startsWith('https://')
+                        ? screenshot
+                        : screenshot.startsWith('/') && (screenshot.endsWith('.png') || screenshot.endsWith('.jpg') || screenshot.endsWith('.jpeg') || screenshot.endsWith('.webp'))
+                            ? screenshot
+                            : `data:image/jpeg;base64,${screenshot}`;
+            return { ...t, state: { ...state, screenshot: screenshotDataUrl } };
+        });
+        const recording = recordings.find(rec => rec.testId === 'default') ?? recordings[0];
+        return {
+            ...data,
+            tests: [{
+                    id: 'default',
+                    name: 'run',
+                    recording: recording ? recording.relPath : null,
+                    turns,
+                }],
+        };
+    }
+    return data;
+}
+/**
+ * Escape a JSON string for safe inlining inside a `<script>` block.
+ *
+ * The hazards:
+ *   - `</script` (any case): closes the script tag mid-string
+ *   - `<!--`: opens an HTML comment, toggles parser modes
+ *   - U+2028 / U+2029: legal in JSON, illegal in pre-ES2019 JS string literals
+ *
+ * Exported for testing.
+ */
+export function escapeJsonForScript(json) {
+    return json
+        .replace(/<\/(script)/gi, '<\\/$1')
+        .replace(/<!--/g, '<\\!--')
+        .replace(/\u2028/g, '\\u2028')
+        .replace(/\u2029/g, '\\u2029');
+}
+const MIME = {
+    '.html': 'text/html; charset=utf-8',
+    '.htm': 'text/html; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.txt': 'text/plain; charset=utf-8',
+    '.md': 'text/markdown; charset=utf-8',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.webp': 'image/webp',
+    '.gif': 'image/gif',
+    '.svg': 'image/svg+xml',
+    '.ico': 'image/x-icon',
+    '.css': 'text/css',
+    '.js': 'application/javascript',
+    '.mjs': 'application/javascript',
+    '.map': 'application/json',
+    '.webm': 'video/webm',
+    '.mp4': 'video/mp4',
+    '.mov': 'video/quicktime',
+};
+function openInBrowser(url) {
+    const cmd = process.platform === 'darwin' ? 'open'
+        : process.platform === 'win32' ? 'start'
+            : 'xdg-open';
+    try {
+        spawn(cmd, [url], { detached: true, stdio: 'ignore' }).unref();
+    }
+    catch {
+        // Best-effort — user can copy the URL from the terminal
+    }
+}
+/**
+ * Listen on a port, auto-incrementing on EADDRINUSE up to `maxRetries` times.
+ */
+async function listenWithRetry(server, startPort, maxRetries) {
+    for (let i = 0; i <= maxRetries; i++) {
+        const port = startPort + i;
+        try {
+            await new Promise((resolve, reject) => {
+                const onError = (err) => {
+                    server.removeListener('listening', onListening);
+                    reject(err);
+                };
+                const onListening = () => {
+                    server.removeListener('error', onError);
+                    resolve();
+                };
+                server.once('error', onError);
+                server.once('listening', onListening);
+                server.listen(port, '127.0.0.1');
+            });
+            return port;
+        }
+        catch (err) {
+            const code = err.code;
+            if (code !== 'EADDRINUSE')
+                throw err;
+            // Try the next port
+            continue;
+        }
+    }
+    throw new ViewError(`could not bind to any port in range ${startPort}–${startPort + maxRetries} (all in use)`);
+}
+export async function runView(opts) {
+    const runDir = path.resolve(opts.runDir);
+    if (!fs.existsSync(runDir) || !fs.statSync(runDir).isDirectory()) {
+        throw new ViewError(`run directory not found: ${runDir}`);
+    }
+    const reportPath = findReportJson(runDir);
+    if (!reportPath) {
+        throw new ViewError(`no report.json found in ${runDir} or its subdirectories`);
+    }
+    if (!VIEWER_HTML_PATH) {
+        throw new ViewError('viewer.html not found. The package may be missing dist/viewer/viewer.html — try reinstalling.');
+    }
+    const reportRoot = path.dirname(reportPath);
+    const viewerSource = fs.readFileSync(VIEWER_HTML_PATH, 'utf-8');
+    const reportRaw = fs.readFileSync(reportPath, 'utf-8');
+    // Parse the report, discover any recording.webm files alongside it, and
+    // normalize the shape so the viewer sees a consistent format whether
+    // this is a design-audit run or an agent suite run.
+    let reportObj;
+    try {
+        reportObj = JSON.parse(reportRaw);
+    }
+    catch {
+        throw new ViewError(`report.json is not valid JSON: ${reportPath}`);
+    }
+    const recordings = findRecordings(reportRoot);
+    const normalized = normalizeReport(reportObj, recordings);
+    const reportJson = JSON.stringify(normalized);
+    const safeJson = escapeJsonForScript(reportJson);
+    const inlinedHtml = viewerSource.replace('const runData = window.__bad_runData || null;', `const runData = ${safeJson};`);
+    const server = http.createServer((req, res) => {
+        const urlPath = (req.url ?? '/').split('?')[0];
+        if (urlPath === '/' || urlPath === '/index.html') {
+            res.writeHead(200, { 'Content-Type': MIME['.html'] });
+            res.end(inlinedHtml);
+            return;
+        }
+        // Path-traversal protection: resolve, check the path stays inside
+        // reportRoot via path.relative (startsWith on the prefix is buggy
+        // because /tmp/runA-evil shares a prefix with /tmp/runA), and
+        // resolve symlinks so they can't escape the sandbox.
+        const decoded = decodeURIComponent(urlPath);
+        const candidate = path.resolve(reportRoot, decoded.replace(/^\/+/, ''));
+        const rel = path.relative(reportRoot, candidate);
+        if (rel.startsWith('..') || path.isAbsolute(rel)) {
+            res.writeHead(403);
+            res.end('forbidden');
+            return;
+        }
+        let realPath;
+        try {
+            realPath = fs.realpathSync(candidate);
+        }
+        catch {
+            res.writeHead(404);
+            res.end('not found');
+            return;
+        }
+        const realRel = path.relative(reportRoot, realPath);
+        if (realRel.startsWith('..') || path.isAbsolute(realRel)) {
+            // Symlink escaped the sandbox
+            res.writeHead(403);
+            res.end('forbidden');
+            return;
+        }
+        if (!fs.statSync(realPath).isFile()) {
+            res.writeHead(404);
+            res.end('not found');
+            return;
+        }
+        const ext = path.extname(realPath).toLowerCase();
+        res.writeHead(200, {
+            'Content-Type': MIME[ext] ?? 'application/octet-stream',
+            'Cache-Control': 'no-cache',
+        });
+        fs.createReadStream(realPath).pipe(res);
+    });
+    const port = await listenWithRetry(server, opts.port ?? 7777, opts.portRetries ?? 10);
+    const url = `http://localhost:${port}`;
+    console.log('');
+    console.log(`  ${chalk.bold('bad view')}`);
+    console.log(`  ${chalk.dim('Run:')} ${reportRoot}`);
+    console.log(`  ${chalk.dim('URL:')} ${chalk.cyan(url)}`);
+    console.log(`  ${chalk.dim('Press Ctrl+C to stop')}`);
+    console.log('');
+    if (!opts.noOpen) {
+        openInBrowser(url);
+    }
+    const close = () => new Promise(resolve => {
+        server.close(() => resolve());
+    });
+    return { url, close };
+}
+/**
+ * CLI entrypoint that calls runView and keeps the process alive until SIGINT.
+ * Throws ViewError on failure — the dispatcher in cli.ts catches and exits.
+ */
+export async function runViewCli(opts) {
+    const { close } = await runView(opts);
+    // Keep alive until SIGINT
+    await new Promise(resolve => {
+        const onSigint = () => {
+            console.log('\n  closing viewer…');
+            void close().then(resolve);
+        };
+        process.once('SIGINT', onSigint);
+    });
+}
+//# sourceMappingURL=cli-view.js.map

package/dist/cli-view.js.map

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

package/dist/cli.js

@@ -108,6 +108,12 @@ async function main() {
             'evolve-rounds': { type: 'string' },
             'project-dir': { type: 'string' },
             reproducibility: { type: 'boolean' },
+            'rubrics-dir': { type: 'string' },
+            // bad view
+            port: { type: 'string' },
+            'no-open': { type: 'boolean' },
+            // bad run --show-cursor (overlay)
+            'show-cursor': { type: 'boolean' },
             // showcase
             script: { type: 'string' },
             capture: { type: 'string' },
@@ -178,6 +184,29 @@ async function main() {
         process.exit(0);
     }
     const command = positionals[0];
+    if (command === 'view') {
+        const runDir = positionals[1];
+        if (!runDir) {
+            cliError('usage: bad view <run-directory>');
+            process.exit(1);
+        }
+        const { runViewCli, ViewError } = await import('./cli-view.js');
+        try {
+            await runViewCli({
+                runDir,
+                port: values.port ? parseInt(values.port) : undefined,
+                noOpen: values['no-open'],
+            });
+        }
+        catch (err) {
+            if (err instanceof ViewError) {
+                cliError(err.message);
+                process.exit(1);
+            }
+            throw err;
+        }
+        return;
+    }
     if (command === 'design-audit') {
         if (!values.url) {
             cliError('--url is required for design-audit.');
@@ -226,6 +255,7 @@ async function main() {
             evolveRounds: values['evolve-rounds'] ? parseInt(values['evolve-rounds']) : undefined,
             projectDir: values['project-dir'],
             reproducibility: values.reproducibility,
+            rubricsDir: values['rubrics-dir'],
         });
         process.exit(0);
     }
@@ -315,7 +345,7 @@ async function main() {
         process.exit(1);
     }
     if (command !== 'run') {
-        cliError(`Unknown command: ${command}. Use "run", "runs", "design-audit", "showcase", or "auth".`);
+        cliError(`Unknown command: ${command}. Use "run", "runs", "design-audit", "view", "showcase", or "auth".`);
         process.exit(1);
     }
     // Validate inputs
@@ -1146,6 +1176,7 @@ async function main() {
             timeout: actionTimeout,
             visionStrategy: config.visionStrategy,
             screenshotInterval,
+            showCursor: values['show-cursor'],
         });
         // Apply resource blocking if configured
         const resourceBlockingStartedAt = Date.now();