@tangle-network/browser-agent-driver 0.8.7 → 0.11.0

package/dist/showcase/index.js

@@ -0,0 +1,289 @@
+/**
+ * Showcase — deterministic walkthrough capture for marketing assets.
+ *
+ * Unlike `bad run` (LLM-driven exploration) or `bad design-audit` (quality assessment),
+ * showcase executes a pre-scripted walkthrough and captures polished screenshots,
+ * GIFs, and videos. No LLM calls. No quality judgement. Just beautiful captures.
+ *
+ * Reuses:
+ *   - page-interaction.ts: dismissModals() for cookie/popup cleanup
+ *   - browser-launch.ts: buildBrowserLaunchPlan() for consistent browser config
+ *   - cli-ui.ts: CliRenderer for progress output
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { chromium } from 'playwright';
+import { captureWithHighlight, captureWithCrop } from './annotate.js';
+import { assembleGif } from './assemble.js';
+import { revealHiddenContent } from '../design/page-interaction.js';
+// ── Main Entry ──
+export async function runShowcase(config) {
+    const startTime = Date.now();
+    const outputDir = config.output?.dir ?? './showcase';
+    const scale = config.output?.scale ?? 2;
+    const formats = config.output?.formats ?? ['png'];
+    const quality = config.output?.quality ?? 90;
+    fs.mkdirSync(outputDir, { recursive: true });
+    const viewport = config.viewport ?? { width: 1440, height: 900 };
+    const browser = await chromium.launch({ headless: config.headless ?? true });
+    const context = await browser.newContext({
+        viewport,
+        deviceScaleFactor: scale,
+        colorScheme: config.colorScheme,
+        storageState: config.storageState ? JSON.parse(fs.readFileSync(config.storageState, 'utf-8')) : undefined,
+        // Record video if webm format requested
+        ...(formats.includes('webm') ? { recordVideo: { dir: path.join(outputDir, '_video'), size: viewport } } : {}),
+    });
+    const page = await context.newPage();
+    const frames = [];
+    // Dismiss modals/cookie banners before starting
+    if (config.dismissModals !== false) {
+        await page.goto(config.url, { waitUntil: 'networkidle', timeout: 30_000 }).catch(() => page.goto(config.url, { waitUntil: 'domcontentloaded', timeout: 30_000 }));
+        await page.waitForTimeout(1500);
+        // Dismiss modals/cookie banners — reuses design/page-interaction.ts
+        await revealHiddenContent(page).catch(() => null);
+    }
+    // Execute steps
+    for (let i = 0; i < config.steps.length; i++) {
+        const step = config.steps[i];
+        await executeStep(page, step);
+        if (step.capture) {
+            const frame = await captureFrame(page, step.capture, i, { quality });
+            if (frame) {
+                const framePath = path.join(outputDir, `${frame.name}.png`);
+                fs.writeFileSync(framePath, frame.buffer);
+                frames.push(frame);
+            }
+        }
+    }
+    // Generate interactive demo HTML if requested
+    let demoPath;
+    if (formats.includes('demo')) {
+        const { buildDemoSteps, generateDemoHtml } = await import('./demo-player.js');
+        // Build demo steps — hotspot calculation is best-effort
+        // Try to navigate back for element positions, but don't fail if it errors
+        let demoPage;
+        try {
+            await page.goto(config.url, { waitUntil: 'domcontentloaded', timeout: 10_000 });
+            await page.waitForTimeout(1000);
+            demoPage = page;
+        }
+        catch {
+            // Can't navigate back — build demo without hotspots
+        }
+        const demoSteps = await buildDemoSteps(outputDir, config.steps, demoPage);
+        const demoHtml = generateDemoHtml({
+            title: config.name.replace(/-/g, ' ').replace(/\b\w/g, c => c.toUpperCase()),
+            steps: demoSteps,
+        });
+        demoPath = path.join(outputDir, `${config.name}-demo.html`);
+        fs.writeFileSync(demoPath, demoHtml);
+    }
+    // Assemble GIF if requested
+    let gifPath;
+    if (formats.includes('gif') && frames.length > 1) {
+        gifPath = path.join(outputDir, `${config.name}.gif`);
+        const ok = assembleGif(frames, gifPath, { fps: 1, maxWidth: viewport.width });
+        if (!ok)
+            gifPath = undefined;
+    }
+    // Get video recording path if available
+    let videoPath;
+    if (formats.includes('webm')) {
+        await page.close(); // Must close page to flush video
+        const videoFile = await context.pages()[0]?.video()?.path().catch(() => undefined);
+        // Page already closed, try getting video from context
+        // Video is written on context.close()
+        await context.close();
+        const videoDir = path.join(outputDir, '_video');
+        if (fs.existsSync(videoDir)) {
+            const vids = fs.readdirSync(videoDir).filter(f => f.endsWith('.webm'));
+            if (vids.length) {
+                videoPath = path.join(outputDir, `${config.name}.webm`);
+                fs.renameSync(path.join(videoDir, vids[0]), videoPath);
+                fs.rmSync(videoDir, { recursive: true, force: true });
+            }
+        }
+    }
+    else {
+        await context.close();
+    }
+    await browser.close();
+    // Convert to WebP if requested
+    if (formats.includes('webp')) {
+        for (const frame of frames) {
+            const pngPath = path.join(outputDir, `${frame.name}.png`);
+            // Playwright can't export webp directly from buffer,
+            // but we keep the PNG — webp conversion would need sharp or ffmpeg
+        }
+    }
+    return {
+        name: config.name,
+        outputDir,
+        frames: frames.map((f) => ({
+            name: f.name,
+            path: path.join(outputDir, `${f.name}.png`),
+            width: f.width,
+            height: f.height,
+            step: f.step,
+        })),
+        gif: gifPath,
+        video: videoPath,
+        demo: demoPath,
+        durationMs: Date.now() - startTime,
+    };
+}
+// ── Quick Capture ──
+/**
+ * Quick capture mode — no script file needed.
+ * Captures named positions: 'hero' (viewport), 'full' (full page), 'scroll:N' (scroll N px first).
+ */
+export async function quickCapture(config) {
+    const steps = [
+        { action: 'navigate', url: config.url },
+    ];
+    for (const capture of config.captures) {
+        if (capture === 'hero') {
+            steps.push({
+                action: 'screenshot',
+                capture: {
+                    name: 'hero',
+                    fullPage: false,
+                    crop: config.cropSelector ? { selector: config.cropSelector, padding: 16 } : undefined,
+                    highlight: config.highlightSelector ? { selector: config.highlightSelector } : undefined,
+                },
+            });
+        }
+        else if (capture === 'full') {
+            steps.push({
+                action: 'screenshot',
+                capture: { name: 'full-page', fullPage: true },
+            });
+        }
+        else if (capture.startsWith('scroll:')) {
+            const amount = parseInt(capture.split(':')[1], 10);
+            steps.push({ action: 'scroll', amount }, {
+                action: 'screenshot',
+                capture: {
+                    name: `scroll-${amount}`,
+                    fullPage: false,
+                    crop: config.cropSelector ? { selector: config.cropSelector, padding: 16 } : undefined,
+                },
+            });
+        }
+        else if (capture === 'footer') {
+            steps.push({ action: 'scroll', amount: 99999 }, { action: 'screenshot', capture: { name: 'footer', fullPage: false } });
+        }
+        else {
+            // Treat as a section name — try scrolling to an element with that id or class
+            steps.push({ action: 'screenshot', capture: { name: capture, fullPage: false } });
+        }
+    }
+    return runShowcase({
+        name: 'quick-capture',
+        url: config.url,
+        steps,
+        viewport: config.viewport,
+        output: config.output,
+        headless: config.headless,
+        storageState: config.storageState,
+        colorScheme: config.colorScheme,
+        dismissModals: config.dismissModals,
+    });
+}
+// ── Internals ──
+async function executeStep(page, step) {
+    switch (step.action) {
+        case 'navigate':
+            if (step.url) {
+                await page.goto(step.url, { waitUntil: 'networkidle', timeout: 30_000 }).catch(() => page.goto(step.url, { waitUntil: 'domcontentloaded', timeout: 30_000 }));
+                await page.waitForTimeout(1500);
+            }
+            break;
+        case 'click':
+            if (step.selector) {
+                const el = page.locator(step.selector).first();
+                await el.click({ timeout: 5_000 }).catch(() => {
+                    // Fallback: try force click
+                    return el.click({ force: true, timeout: 3_000 }).catch(() => null);
+                });
+                await page.waitForTimeout(500);
+            }
+            break;
+        case 'type':
+            if (step.selector && step.text) {
+                const el = page.locator(step.selector).first();
+                await el.click({ timeout: 3_000 }).catch(() => null);
+                await el.fill(step.text);
+                await page.waitForTimeout(300);
+            }
+            break;
+        case 'scroll':
+            const amount = step.amount ?? 500;
+            const dir = step.direction === 'up' ? -1 : 1;
+            await page.evaluate((px) => window.scrollBy(0, px), amount * dir);
+            await page.waitForTimeout(500);
+            break;
+        case 'wait':
+            await page.waitForTimeout(step.amount ?? 1000);
+            break;
+        case 'hover':
+            if (step.selector) {
+                await page.locator(step.selector).first().hover({ timeout: 3_000 }).catch(() => null);
+                await page.waitForTimeout(300);
+            }
+            break;
+        case 'screenshot':
+            // Screenshot-only step — capture handled by caller
+            break;
+    }
+}
+async function captureFrame(page, capture, stepIndex, opts) {
+    // Wait for animations to settle
+    if (capture.delay) {
+        await page.waitForTimeout(capture.delay);
+    }
+    let buffer;
+    if (capture.highlight) {
+        // Capture with highlight overlay
+        buffer = await captureWithHighlight(page, {
+            selector: capture.highlight.selector,
+            color: capture.highlight.color,
+            label: capture.highlight.label,
+            fullPage: capture.fullPage,
+            quality: opts.quality,
+        });
+    }
+    else if (capture.crop) {
+        // Capture cropped to element
+        const cropped = await captureWithCrop(page, {
+            selector: capture.crop.selector,
+            padding: capture.crop.padding,
+            quality: opts.quality,
+        });
+        if (!cropped) {
+            // Fallback: full viewport
+            buffer = await page.screenshot({ type: 'png', fullPage: false });
+        }
+        else {
+            buffer = cropped;
+        }
+    }
+    else {
+        // Standard capture
+        buffer = await page.screenshot({
+            type: 'png',
+            fullPage: capture.fullPage ?? false,
+        });
+    }
+    // Get dimensions from viewport (actual pixel dimensions depend on scale factor)
+    const viewport = page.viewportSize();
+    return {
+        name: capture.name,
+        buffer,
+        width: viewport?.width ?? 1440,
+        height: viewport?.height ?? 900,
+        step: stepIndex,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/showcase/index.js.map

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

package/dist/showcase/types.d.ts

@@ -0,0 +1,111 @@
+/** Types for the `bad showcase` walkthrough capture system. */
+export type ShowcaseAction = 'navigate' | 'click' | 'type' | 'scroll' | 'wait' | 'hover' | 'screenshot';
+export interface CaptureConfig {
+    /** Output filename stem (no extension). */
+    name: string;
+    /** Capture full page or viewport only. Default: false (viewport). */
+    fullPage?: boolean;
+    /** Crop to a specific element. */
+    crop?: {
+        selector: string;
+        /** Padding in px around the element bounding box. Default: 0. */
+        padding?: number;
+    };
+    /** Draw a highlight rectangle on an element. */
+    highlight?: {
+        selector: string;
+        /** CSS color. Default: rgba(142, 89, 255, 0.5). */
+        color?: string;
+        /** Optional text label above the highlight. */
+        label?: string;
+    };
+    /** Delay in ms before capture (let animations settle). Default: 0. */
+    delay?: number;
+}
+export interface ShowcaseStep {
+    action: ShowcaseAction;
+    /** CSS selector (for click, type, hover). */
+    selector?: string;
+    /** Text to type (for type action). */
+    text?: string;
+    /** URL (for navigate action). */
+    url?: string;
+    /** Pixels to scroll (scroll action) or ms to wait (wait action). */
+    amount?: number;
+    /** Scroll direction. Default: 'down'. */
+    direction?: 'up' | 'down';
+    /** Capture a screenshot after this step completes. */
+    capture?: CaptureConfig;
+}
+export interface ShowcaseConfig {
+    /** Human name for this showcase (used in output directory). */
+    name: string;
+    /** Starting URL. */
+    url: string;
+    /** Browser viewport. Default: { width: 1440, height: 900 }. */
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    /** Ordered steps to execute. */
+    steps: ShowcaseStep[];
+    /** Output options. */
+    output?: {
+        dir?: string;
+        /** Which formats to generate. Default: ['png']. */
+        formats?: Array<'png' | 'webp' | 'gif' | 'webm' | 'demo'>;
+        /** Image quality 1-100. Default: 90. */
+        quality?: number;
+        /** Device scale factor. Default: 2 (retina). */
+        scale?: number;
+    };
+    /** Run headless. Default: true. */
+    headless?: boolean;
+    /** Playwright storage state for auth. */
+    storageState?: string;
+    /** Force color scheme. */
+    colorScheme?: 'dark' | 'light';
+    /** Dismiss cookie banners and modals before starting. Default: true. */
+    dismissModals?: boolean;
+}
+export interface QuickCaptureConfig {
+    url: string;
+    /** Named capture positions. 'hero' = viewport, 'full' = full page, 'scroll:N' = scroll N px. */
+    captures: string[];
+    /** Crop all captures to this element. */
+    cropSelector?: string;
+    /** Highlight this element in all captures. */
+    highlightSelector?: string;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    output?: ShowcaseConfig['output'];
+    headless?: boolean;
+    storageState?: string;
+    colorScheme?: 'dark' | 'light';
+    dismissModals?: boolean;
+}
+export interface ShowcaseFrame {
+    name: string;
+    buffer: Buffer;
+    width: number;
+    height: number;
+    step: number;
+}
+export interface ShowcaseResult {
+    name: string;
+    outputDir: string;
+    frames: Array<{
+        name: string;
+        path: string;
+        width: number;
+        height: number;
+        step: number;
+    }>;
+    gif?: string;
+    video?: string;
+    demo?: string;
+    durationMs: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/showcase/types.d.ts.map

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

package/dist/showcase/types.js

@@ -0,0 +1,3 @@
+/** Types for the `bad showcase` walkthrough capture system. */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/showcase/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/showcase/types.ts"],"names":[],"mappings":"AAAA,+DAA+D"}

package/dist/test-runner.d.ts

@@ -56,6 +56,7 @@ export declare class TestRunner {
     private stopOnFailure;
     private store;
     private projectStore?;
+    private runRegistry?;
     private feedbackHints;
     private screenshotInterval;
     private analyzer;

package/dist/test-runner.d.ts.map

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

package/dist/test-runner.js

@@ -7,11 +7,12 @@
 import { existsSync, readFileSync, unlinkSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
-import { AgentRunner } from './runner.js';
+import { BrowserAgent } from './runner.js';
 import { Brain } from './brain/index.js';
 import { TrajectoryStore } from './memory/store.js';
 import { TrajectoryAnalyzer } from './memory/analyzer.js';
 import { AppKnowledge } from './memory/knowledge.js';
+import { RunRegistry } from './memory/run-registry.js';
 import { generateReport } from './test-report.js';
 const DEFAULT_MAX_TURNS = 30;
 import { loadPricing, calculateCost } from './model-pricing.js';
@@ -53,6 +54,7 @@ export class TestRunner {
     stopOnFailure;
     store;
     projectStore;
+    runRegistry;
     feedbackHints;
     screenshotInterval;
     analyzer;
@@ -74,6 +76,7 @@ export class TestRunner {
         this.concurrency = options.concurrency ?? 1;
         this.stopOnFailure = options.stopOnFailure ?? false;
         this.projectStore = options.projectStore;
+        this.runRegistry = options.projectStore ? new RunRegistry(options.projectStore.getRoot()) : undefined;
         this.store = options.enableMemory
             ? new TrajectoryStore(options.trajectoryStorePath, {
                 enableScoring: this.config.traceScoring === true,
@@ -133,11 +136,12 @@ export class TestRunner {
                     ? `${combinedReference}\n\n${this.feedbackHints}`
                     : this.feedbackHints;
             }
-            const runner = new AgentRunner({
+            const runner = new BrowserAgent({
                 driver: activeDriver,
                 config: this.config,
                 referenceTrajectory: combinedReference,
                 projectStore: this.projectStore,
+                runRegistry: this.runRegistry,
                 onTurn: (turn) => {
                     if (timeToFirstTurnMs === undefined) {
                         timeToFirstTurnMs = Math.max(0, Date.now() - runStartedAtMs);
@@ -200,6 +204,8 @@ export class TestRunner {
                 allowedDomains: testCase.allowedDomains,
                 maxTurns: testCase.maxTurns ?? DEFAULT_MAX_TURNS,
                 signal: combinedSignal,
+                sessionId: testCase.sessionId,
+                parentRunId: testCase.parentRunId,
             });
             let agentResult;
             if (timeoutMs && timeoutMs > 0 && timeoutAbortController) {
@@ -312,6 +318,24 @@ export class TestRunner {
                     // Video capture is best-effort
                 }
             }
+            // Update run manifest with artifact paths from the sink
+            if (this.runRegistry && this.artifactSink) {
+                const manifest = this.artifactSink.getManifest();
+                const testArtifacts = manifest
+                    .filter(e => e.testId === testCase.id)
+                    .map(e => e.uri);
+                if (testArtifacts.length > 0) {
+                    // Find the matching run manifest by sessionId or recent domain runs
+                    const runs = this.runRegistry.listRuns({
+                        sessionId: testCase.sessionId,
+                        status: 'completed',
+                        limit: 1,
+                    });
+                    if (runs.length > 0) {
+                        this.runRegistry.updateRun(runs[0].runId, { artifactPaths: testArtifacts });
+                    }
+                }
+            }
             this.onTestComplete?.(result);
             this.onProgress?.({
                 type: 'test:complete',