@tangle-network/browser-agent-driver 0.6.0

package/dist/design-audit.js

@@ -0,0 +1,172 @@
+/**
+ * Design Audit System — systematic UI/UX flow auditing with vision.
+ *
+ * Navigates through UI flows, captures screenshots at checkpoints,
+ * evaluates visual quality, UX patterns, accessibility, and design
+ * consistency. Produces structured reports with findings.
+ */
+import { Brain } from './brain/index.js';
+import { AgentRunner } from './runner.js';
+/**
+ * DesignAuditor — orchestrates flow navigation + screenshot capture + evaluation.
+ *
+ * Usage:
+ * ```ts
+ * const auditor = new DesignAuditor(driver, { model: 'gpt-4o', vision: true });
+ * const report = await auditor.audit([
+ *   { name: 'login', startUrl: 'http://localhost:5173', goal: 'Navigate to the login page', checkpoints: ['Login form is visible'] },
+ *   { name: 'chat', startUrl: 'http://localhost:5173/chat', goal: 'Send a message in chat', checkpoints: ['Chat input is visible', 'Message appears'] },
+ * ]);
+ * console.log(generateDesignAuditReport(report));
+ * ```
+ */
+export class DesignAuditor {
+    driver;
+    brain;
+    config;
+    constructor(driver, config = {}) {
+        this.driver = driver;
+        this.config = { ...config, vision: true }; // Vision must be on for design audit
+        this.brain = new Brain(this.config);
+    }
+    /**
+     * Audit a single flow — agent navigates toward the goal, captures
+     * screenshots at checkpoints, and evaluates design quality.
+     */
+    async auditFlow(flow) {
+        const screenshots = [];
+        const allFindings = [];
+        // Use the runner to navigate the flow
+        const runner = new AgentRunner({
+            driver: this.driver,
+            config: this.config,
+            onTurn: (turn) => {
+                if (turn.state.screenshot) {
+                    screenshots.push(turn.state.screenshot);
+                }
+            },
+        });
+        const result = await runner.run({
+            goal: flow.goal,
+            startUrl: flow.startUrl,
+            maxTurns: flow.maxTurns ?? 15,
+        });
+        // Evaluate checkpoints — capture + audit at the final state
+        const finalState = result.turns.length > 0
+            ? result.turns[result.turns.length - 1].state
+            : await this.driver.observe();
+        // Run design evaluation on the final state
+        const evaluation = await this.brain.auditDesign(finalState, flow.goal, flow.checkpoints);
+        allFindings.push(...evaluation.findings);
+        // Keep only key screenshots (first, middle, last) to avoid bloat
+        const keyScreenshots = [];
+        if (screenshots.length > 0)
+            keyScreenshots.push(screenshots[0]);
+        if (screenshots.length > 2)
+            keyScreenshots.push(screenshots[Math.floor(screenshots.length / 2)]);
+        if (screenshots.length > 1)
+            keyScreenshots.push(screenshots[screenshots.length - 1]);
+        return {
+            flow: flow.name,
+            steps: result.turns.length,
+            reachedGoal: result.success,
+            findings: allFindings,
+            screenshots: keyScreenshots,
+            score: evaluation.score,
+        };
+    }
+    /**
+     * Audit multiple flows and produce an aggregate report.
+     * Individual flow failures are caught and reported, not propagated.
+     *
+     * Flows run sequentially by default since they share a browser page.
+     * Pass `onFlowComplete` for progress reporting on long audits.
+     */
+    async audit(flows, options) {
+        const flowResults = [];
+        for (let i = 0; i < flows.length; i++) {
+            const flow = flows[i];
+            try {
+                const result = await this.auditFlow(flow);
+                flowResults.push(result);
+            }
+            catch (err) {
+                // Capture partial result for failed flows
+                flowResults.push({
+                    flow: flow.name,
+                    steps: 0,
+                    reachedGoal: false,
+                    findings: [],
+                    screenshots: [],
+                    score: 1,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+            options?.onFlowComplete?.(flow.name, i + 1, flows.length);
+        }
+        // Compute summary
+        const allFindings = flowResults.flatMap(f => f.findings);
+        const critical = allFindings.filter(f => f.severity === 'critical').length;
+        const major = allFindings.filter(f => f.severity === 'major').length;
+        const minor = allFindings.filter(f => f.severity === 'minor').length;
+        // Health score: 100 - (critical * 15 + major * 5 + minor * 1), clamped to 0-100
+        const deductions = critical * 15 + major * 5 + minor * 1;
+        const healthScore = Math.max(0, Math.min(100, 100 - deductions));
+        return {
+            timestamp: new Date().toISOString(),
+            flows: flowResults,
+            summary: {
+                healthScore,
+                totalFindings: allFindings.length,
+                critical,
+                major,
+                minor,
+            },
+        };
+    }
+}
+/**
+ * Generate a markdown report from a DesignAuditReport.
+ */
+export function generateDesignAuditReport(report) {
+    const lines = [];
+    lines.push('# Design Audit Report');
+    lines.push(`**Date:** ${report.timestamp}`);
+    lines.push(`**Health Score:** ${report.summary.healthScore}/100`);
+    lines.push('');
+    // Summary
+    lines.push('## Summary');
+    lines.push('');
+    lines.push(`| Metric | Value |`);
+    lines.push(`|--------|-------|`);
+    lines.push(`| Total Findings | ${report.summary.totalFindings} |`);
+    lines.push(`| Critical | ${report.summary.critical} |`);
+    lines.push(`| Major | ${report.summary.major} |`);
+    lines.push(`| Minor | ${report.summary.minor} |`);
+    lines.push(`| Flows Audited | ${report.flows.length} |`);
+    lines.push('');
+    // Per-flow results
+    for (const flow of report.flows) {
+        lines.push(`## Flow: ${flow.flow}`);
+        const goalStatus = flow.reachedGoal ? 'Reached' : 'Not reached';
+        lines.push(`**Steps:** ${flow.steps} | **Score:** ${flow.score}/10 | **Goal:** ${goalStatus}`);
+        if (flow.error) {
+            lines.push(`**Error:** ${flow.error}`);
+        }
+        lines.push('');
+        if (flow.findings.length === 0) {
+            lines.push('No issues found.');
+        }
+        else {
+            lines.push('| Severity | Category | Description | Location | Suggestion |');
+            lines.push('|----------|----------|-------------|----------|------------|');
+            for (const f of flow.findings) {
+                const esc = (s) => s.replace(/\|/g, '\\|').replace(/\n/g, ' ');
+                lines.push(`| ${f.severity} | ${f.category} | ${esc(f.description)} | ${esc(f.location)} | ${esc(f.suggestion)} |`);
+            }
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=design-audit.js.map

package/dist/design-audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-audit.js","sourceRoot":"","sources":["../src/design-audit.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAS1C;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,aAAa;IAChB,MAAM,CAAS;IACf,KAAK,CAAQ;IACb,MAAM,CAAc;IAE5B,YAAY,MAAc,EAAE,SAAsB,EAAE;QAClD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,qCAAqC;QAChF,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS,CAAC,IAAe;QAC7B,MAAM,WAAW,GAAa,EAAE,CAAC;QACjC,MAAM,WAAW,GAAoB,EAAE,CAAC;QAExC,sCAAsC;QACtC,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC;YAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;gBACf,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;oBAC1B,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC1C,CAAC;YACH,CAAC;SACF,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC;YAC9B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE;SAC9B,CAAC,CAAC;QAEH,4DAA4D;QAC5D,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;YACxC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK;YAC7C,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAEhC,2CAA2C;QAC3C,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAEzF,WAAW,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;QAEzC,iEAAiE;QACjE,MAAM,cAAc,GAAa,EAAE,CAAC;QACpC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;YAAE,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;YAAE,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACjG,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;YAAE,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;QAErF,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;YAC1B,WAAW,EAAE,MAAM,CAAC,OAAO;YAC3B,QAAQ,EAAE,WAAW;YACrB,WAAW,EAAE,cAAc;YAC3B,KAAK,EAAE,UAAU,CAAC,KAAK;SACxB,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,CACT,KAAkB,EAClB,OAAuF;QAEvF,MAAM,WAAW,GAAsB,EAAE,CAAC;QAE1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBAC1C,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC3B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,0CAA0C;gBAC1C,WAAW,CAAC,IAAI,CAAC;oBACf,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,KAAK,EAAE,CAAC;oBACR,WAAW,EAAE,KAAK;oBAClB,QAAQ,EAAE,EAAE;oBACZ,WAAW,EAAE,EAAE;oBACf,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBACxD,CAAC,CAAC;YACL,CAAC;YACD,OAAO,EAAE,cAAc,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5D,CAAC;QAED,kBAAkB;QAClB,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,MAAM,CAAC;QAC3E,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;QACrE,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;QAErE,gFAAgF;QAChF,MAAM,UAAU,GAAG,QAAQ,GAAG,EAAE,GAAG,KAAK,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;QACzD,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC;QAEjE,OAAO;YACL,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK,EAAE,WAAW;YAClB,OAAO,EAAE;gBACP,WAAW;gBACX,aAAa,EAAE,WAAW,CAAC,MAAM;gBACjC,QAAQ;gBACR,KAAK;gBACL,KAAK;aACN;SACF,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAyB;IACjE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;IAC5C,KAAK,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,OAAO,CAAC,WAAW,MAAM,CAAC,CAAC;IAClE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,UAAU;IACV,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,sBAAsB,MAAM,CAAC,OAAO,CAAC,aAAa,IAAI,CAAC,CAAC;IACnE,KAAK,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;IACxD,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;IAClD,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;IAClD,KAAK,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,mBAAmB;IACnB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACpC,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC;QAChE,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,KAAK,iBAAiB,IAAI,CAAC,KAAK,mBAAmB,UAAU,EAAE,CAAC,CAAC;QAC/F,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACzC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;YAC5E,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;YAC5E,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC9B,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBACvE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,MAAM,CAAC,CAAC,QAAQ,MAAM,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACtH,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/domain-policy.d.ts

@@ -0,0 +1,4 @@
+import type { GoalVerification } from './types.js';
+export declare function buildFirstPartyBoundaryNote(goal: string, currentUrl: string): string | undefined;
+export declare function shouldAcceptFirstPartyBoundaryCompletion(goal: string, currentUrl: string, verification: GoalVerification, claimedResult: string): boolean;
+//# sourceMappingURL=domain-policy.d.ts.map

package/dist/domain-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-policy.d.ts","sourceRoot":"","sources":["../src/domain-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAqBnD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAYhG;AAED,wBAAgB,wCAAwC,CACtD,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,gBAAgB,EAC9B,aAAa,EAAE,MAAM,GACpB,OAAO,CAoCT"}

package/dist/domain-policy.js

@@ -0,0 +1,69 @@
+function safeHostname(url) {
+    try {
+        return new URL(url).hostname.toLowerCase();
+    }
+    catch {
+        return undefined;
+    }
+}
+function toRegistrableDomain(hostname) {
+    const parts = hostname.toLowerCase().split('.').filter(Boolean);
+    if (parts.length <= 2)
+        return hostname.toLowerCase();
+    return parts.slice(-2).join('.');
+}
+function extractGoalHosts(goal) {
+    const matches = goal.match(/\b(?:[a-z0-9-]+\.)+[a-z]{2,}\b/gi) ?? [];
+    return [...new Set(matches.map((host) => host.toLowerCase()))];
+}
+export function buildFirstPartyBoundaryNote(goal, currentUrl) {
+    const currentHost = safeHostname(currentUrl);
+    if (!currentHost)
+        return undefined;
+    const goalHosts = extractGoalHosts(goal);
+    if (goalHosts.length === 0 || goalHosts.includes(currentHost))
+        return undefined;
+    const currentRoot = toRegistrableDomain(currentHost);
+    const sameSiteHost = goalHosts.find((host) => toRegistrableDomain(host) === currentRoot);
+    if (!sameSiteHost)
+        return undefined;
+    return `SITE BOUNDARY NOTE: The current host "${currentHost}" is a first-party sibling subdomain of "${sameSiteHost}" (shared registrable domain "${currentRoot}"). If the user reached it through official in-site navigation, treat it as the same product/site for completion unless the task clearly depends on the exact host for security, auth, or compliance reasons. Do not fail solely because the subdomain differs.`;
+}
+export function shouldAcceptFirstPartyBoundaryCompletion(goal, currentUrl, verification, claimedResult) {
+    if (verification.achieved)
+        return false;
+    if (!buildFirstPartyBoundaryNote(goal, currentUrl))
+        return false;
+    const bulletCount = claimedResult
+        .split('\n')
+        .filter((line) => /^\s*[-*]\s+/.test(line))
+        .length;
+    if (bulletCount < 3)
+        return false;
+    const boundaryText = [...verification.evidence, ...verification.missing].join('\n').toLowerCase();
+    const boundarySignals = [
+        /subdomain/,
+        /host/,
+        /domain/,
+        /www\./,
+        /only use/,
+        /constraint/,
+        /same site/,
+    ];
+    const substantiveFailureSignals = [
+        /not visible/,
+        /not shown/,
+        /not displayed/,
+        /cannot find/,
+        /could not find/,
+        /missing categories?/,
+        /missing evidence/,
+        /error/,
+        /form/,
+        /button/,
+        /dialog/,
+    ];
+    return boundarySignals.some((pattern) => pattern.test(boundaryText))
+        && !substantiveFailureSignals.some((pattern) => pattern.test(boundaryText));
+}
+//# sourceMappingURL=domain-policy.js.map

package/dist/domain-policy.js.map

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

package/dist/drivers/block-patterns.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Resource blocking patterns for analytics, tracking, ads, images, and media.
+ * Used by PlaywrightDriver.setupResourceBlocking() to abort unnecessary requests.
+ */
+/** Analytics and tracking domain patterns (matched via URL.includes()) */
+export declare const ANALYTICS_PATTERNS: string[];
+/** Image file extension patterns */
+export declare const IMAGE_PATTERNS: string[];
+/** Media file extension patterns */
+export declare const MEDIA_PATTERNS: string[];
+//# sourceMappingURL=block-patterns.d.ts.map

package/dist/drivers/block-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-patterns.d.ts","sourceRoot":"","sources":["../../src/drivers/block-patterns.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,EAAE,MAAM,EA4FtC,CAAC;AAEF,oCAAoC;AACpC,eAAO,MAAM,cAAc,EAAE,MAAM,EAUlC,CAAC;AAEF,oCAAoC;AACpC,eAAO,MAAM,cAAc,EAAE,MAAM,EAUlC,CAAC"}

package/dist/drivers/block-patterns.js

@@ -0,0 +1,123 @@
+/**
+ * Resource blocking patterns for analytics, tracking, ads, images, and media.
+ * Used by PlaywrightDriver.setupResourceBlocking() to abort unnecessary requests.
+ */
+/** Analytics and tracking domain patterns (matched via URL.includes()) */
+export const ANALYTICS_PATTERNS = [
+    // Google
+    'google-analytics.com',
+    'googletagmanager.com',
+    'googlesyndication.com',
+    'googleadservices.com',
+    'google.com/pagead',
+    'doubleclick.net',
+    'googleads.g.doubleclick.net',
+    // Facebook / Meta
+    'facebook.com/tr',
+    'connect.facebook.net',
+    'facebook.net/signals',
+    'fbcdn.net/signals',
+    // Analytics platforms
+    'segment.io',
+    'segment.com',
+    'cdn.segment.com',
+    'mixpanel.com',
+    'amplitude.com',
+    'api.amplitude.com',
+    'cdn.amplitude.com',
+    'heap.io',
+    'heapanalytics.com',
+    'fullstory.com',
+    'rs.fullstory.com',
+    'hotjar.com',
+    'static.hotjar.com',
+    'script.hotjar.com',
+    'clarity.ms',
+    'smartlook.com',
+    'mouseflow.com',
+    'logrocket.com',
+    'cdn.logrocket.io',
+    'posthog.com',
+    'app.posthog.com',
+    'plausible.io',
+    'stats.wp.com',
+    // Ad networks
+    'adroll.com',
+    'adsrvr.org',
+    'criteo.com',
+    'static.criteo.net',
+    'taboola.com',
+    'outbrain.com',
+    'amazon-adsystem.com',
+    'ads-twitter.com',
+    'ads.linkedin.com',
+    'snap.licdn.com',
+    'px.ads.linkedin.com',
+    // Tag managers & data
+    'cdn.rudderlabs.com',
+    'cdn.mxpnl.com',
+    'js-agent.newrelic.com',
+    'bam.nr-data.net',
+    'browser.sentry-cdn.com',
+    'sentry.io/api',
+    'rum.datadog.com',
+    'datadoghq.com',
+    'bugsnag.com',
+    'rollbar.com',
+    // Chat/support widgets
+    'widget.intercom.io',
+    'js.intercomcdn.com',
+    'embed.tawk.to',
+    'static.zdassets.com',
+    'cdn.jsdelivr.net/npm/@drift',
+    // Marketing & tracking pixels
+    'bat.bing.com',
+    'ct.pinterest.com',
+    'analytics.tiktok.com',
+    'snap.licdn.com',
+    'tr.snapchat.com',
+    'sc-static.net/scevent',
+    // Survey/feedback
+    'survicate.com',
+    'qualtrics.com',
+    'usabilla.com',
+    // A/B testing
+    'optimizely.com',
+    'cdn.optimizely.com',
+    'cdn-pci.optimizely.com',
+    'launchdarkly.com',
+    'app.launchdarkly.com',
+    'split.io',
+    'cdn.split.io',
+    'vwo.com',
+    'd5nxst8fruw4z.cloudfront.net', // VWO
+    // Cookie consent (often blocks interaction)
+    'cookiebot.com',
+    'cdn.cookielaw.org',
+    'consentmanager.net',
+];
+/** Image file extension patterns */
+export const IMAGE_PATTERNS = [
+    '.png',
+    '.jpg',
+    '.jpeg',
+    '.gif',
+    '.webp',
+    '.svg',
+    '.ico',
+    '.bmp',
+    '.avif',
+];
+/** Media file extension patterns */
+export const MEDIA_PATTERNS = [
+    '.mp4',
+    '.webm',
+    '.ogg',
+    '.mp3',
+    '.wav',
+    '.flac',
+    '.m4a',
+    '.avi',
+    '.mov',
+];
+//# sourceMappingURL=block-patterns.js.map

package/dist/drivers/block-patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-patterns.js","sourceRoot":"","sources":["../../src/drivers/block-patterns.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,kBAAkB,GAAa;IAC1C,SAAS;IACT,sBAAsB;IACtB,sBAAsB;IACtB,uBAAuB;IACvB,sBAAsB;IACtB,mBAAmB;IACnB,iBAAiB;IACjB,6BAA6B;IAC7B,kBAAkB;IAClB,iBAAiB;IACjB,sBAAsB;IACtB,sBAAsB;IACtB,mBAAmB;IACnB,sBAAsB;IACtB,YAAY;IACZ,aAAa;IACb,iBAAiB;IACjB,cAAc;IACd,eAAe;IACf,mBAAmB;IACnB,mBAAmB;IACnB,SAAS;IACT,mBAAmB;IACnB,eAAe;IACf,kBAAkB;IAClB,YAAY;IACZ,mBAAmB;IACnB,mBAAmB;IACnB,YAAY;IACZ,eAAe;IACf,eAAe;IACf,eAAe;IACf,kBAAkB;IAClB,aAAa;IACb,iBAAiB;IACjB,cAAc;IACd,cAAc;IACd,cAAc;IACd,YAAY;IACZ,YAAY;IACZ,YAAY;IACZ,mBAAmB;IACnB,aAAa;IACb,cAAc;IACd,qBAAqB;IACrB,iBAAiB;IACjB,kBAAkB;IAClB,gBAAgB;IAChB,qBAAqB;IACrB,sBAAsB;IACtB,oBAAoB;IACpB,eAAe;IACf,uBAAuB;IACvB,iBAAiB;IACjB,wBAAwB;IACxB,eAAe;IACf,iBAAiB;IACjB,eAAe;IACf,aAAa;IACb,aAAa;IACb,uBAAuB;IACvB,oBAAoB;IACpB,oBAAoB;IACpB,eAAe;IACf,qBAAqB;IACrB,6BAA6B;IAC7B,8BAA8B;IAC9B,cAAc;IACd,kBAAkB;IAClB,sBAAsB;IACtB,gBAAgB;IAChB,iBAAiB;IACjB,uBAAuB;IACvB,kBAAkB;IAClB,eAAe;IACf,eAAe;IACf,cAAc;IACd,cAAc;IACd,gBAAgB;IAChB,oBAAoB;IACpB,wBAAwB;IACxB,kBAAkB;IAClB,sBAAsB;IACtB,UAAU;IACV,cAAc;IACd,SAAS;IACT,8BAA8B,EAAE,MAAM;IACtC,4CAA4C;IAC5C,eAAe;IACf,mBAAmB;IACnB,oBAAoB;CACrB,CAAC;AAEF,oCAAoC;AACpC,MAAM,CAAC,MAAM,cAAc,GAAa;IACtC,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;CACR,CAAC;AAEF,oCAAoC;AACpC,MAAM,CAAC,MAAM,cAAc,GAAa;IACtC,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;CACP,CAAC"}

package/dist/drivers/cdp-page-state.d.ts

@@ -0,0 +1,22 @@
+/**
+ * CDP-based batched page metadata retrieval.
+ *
+ * Replaces 3 separate Playwright calls (page.url(), page.title(),
+ * page.evaluate(testids)) with a single Runtime.evaluate via CDP.
+ */
+import type { CDPSession } from 'playwright';
+export interface PageMetadata {
+    url: string;
+    title: string;
+    testIds: Array<{
+        testId: string;
+        tag: string;
+        text: string;
+        disabled: boolean;
+    }>;
+}
+/**
+ * Get page URL, title, and data-testid elements in a single CDP call.
+ */
+export declare function getPageMetadata(cdp: CDPSession): Promise<PageMetadata>;
+//# sourceMappingURL=cdp-page-state.d.ts.map

package/dist/drivers/cdp-page-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp-page-state.d.ts","sourceRoot":"","sources":["../../src/drivers/cdp-page-state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,KAAK,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CA6B5E"}

package/dist/drivers/cdp-page-state.js

@@ -0,0 +1,38 @@
+/**
+ * CDP-based batched page metadata retrieval.
+ *
+ * Replaces 3 separate Playwright calls (page.url(), page.title(),
+ * page.evaluate(testids)) with a single Runtime.evaluate via CDP.
+ */
+/**
+ * Get page URL, title, and data-testid elements in a single CDP call.
+ */
+export async function getPageMetadata(cdp) {
+    const { result } = await cdp.send('Runtime.evaluate', {
+        expression: `(() => {
+      const INTERACTIVE = new Set(['button', 'input', 'textarea', 'select', 'a']);
+      const elements = document.querySelectorAll('[data-testid]');
+      const testIds = Array.from(elements)
+        .filter(el => INTERACTIVE.has(el.tagName.toLowerCase()) || el.getAttribute('role'))
+        .slice(0, 30)
+        .map(el => ({
+          testId: el.getAttribute('data-testid') || '',
+          tag: el.tagName.toLowerCase(),
+          text: (el.textContent || '').trim().slice(0, 40),
+          disabled: el.disabled || false,
+        }));
+      return JSON.stringify({
+        url: location.href,
+        title: document.title,
+        testIds,
+      });
+    })()`,
+        returnByValue: true,
+    });
+    if (result.type === 'string') {
+        return JSON.parse(result.value);
+    }
+    // Fallback if evaluate returns unexpected format
+    return { url: '', title: '', testIds: [] };
+}
+//# sourceMappingURL=cdp-page-state.js.map

package/dist/drivers/cdp-page-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp-page-state.js","sourceRoot":"","sources":["../../src/drivers/cdp-page-state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAe;IACnD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE;QACpD,UAAU,EAAE;;;;;;;;;;;;;;;;;SAiBP;QACL,aAAa,EAAE,IAAI;KACpB,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAe,CAAiB,CAAC;IAC5D,CAAC;IAED,iDAAiD;IACjD,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AAC7C,CAAC"}

package/dist/drivers/cdp-snapshot.d.ts

@@ -0,0 +1,32 @@
+/**
+ * CDP-based accessibility tree snapshot.
+ *
+ * Uses Chrome DevTools Protocol `Accessibility.getFullAXTree` to get the
+ * accessibility tree directly as structured AXNode objects — bypassing
+ * Playwright's ariaSnapshot() which serializes to YAML then we regex-parse.
+ *
+ * Produces the same ref-annotated YAML format as the Playwright path so the
+ * rest of the system (Brain, resolveLocator) works unchanged.
+ */
+import type { CDPSession } from 'playwright';
+import type { ParsedElement } from './snapshot.js';
+export interface CdpSnapshotResult {
+    /** Formatted snapshot (same YAML-like format as ariaSnapshot path) */
+    snapshot: string;
+    /** Ref map for resolveLocator integration */
+    refMap: Map<string, {
+        role: string;
+        name: string;
+        backendNodeId?: number;
+    }>;
+    /** Parsed elements for diff tracking */
+    elements: Map<string, ParsedElement>;
+}
+/**
+ * Build an accessibility tree snapshot via CDP.
+ *
+ * Calls `Accessibility.getFullAXTree`, reconstructs the tree structure,
+ * walks depth-first to produce indented YAML lines with stable ref IDs.
+ */
+export declare function buildCdpSnapshot(cdp: CDPSession): Promise<CdpSnapshotResult>;
+//# sourceMappingURL=cdp-snapshot.d.ts.map

package/dist/drivers/cdp-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp-snapshot.d.ts","sourceRoot":"","sources":["../../src/drivers/cdp-snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAgBnD,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,wCAAwC;IACxC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACtC;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAoHlF"}

package/dist/drivers/cdp-snapshot.js

@@ -0,0 +1,120 @@
+/**
+ * CDP-based accessibility tree snapshot.
+ *
+ * Uses Chrome DevTools Protocol `Accessibility.getFullAXTree` to get the
+ * accessibility tree directly as structured AXNode objects — bypassing
+ * Playwright's ariaSnapshot() which serializes to YAML then we regex-parse.
+ *
+ * Produces the same ref-annotated YAML format as the Playwright path so the
+ * rest of the system (Brain, resolveLocator) works unchanged.
+ */
+import { stableHash, INTERACTIVE_ROLES } from './snapshot.js';
+/**
+ * Build an accessibility tree snapshot via CDP.
+ *
+ * Calls `Accessibility.getFullAXTree`, reconstructs the tree structure,
+ * walks depth-first to produce indented YAML lines with stable ref IDs.
+ */
+export async function buildCdpSnapshot(cdp) {
+    const { nodes } = await cdp.send('Accessibility.getFullAXTree');
+    if (!nodes || nodes.length === 0) {
+        return {
+            snapshot: '(empty page)',
+            refMap: new Map(),
+            elements: new Map(),
+        };
+    }
+    // Build lookup: nodeId -> AXNode
+    const nodeMap = new Map();
+    for (const node of nodes) {
+        nodeMap.set(node.nodeId, node);
+    }
+    // Find root nodes (nodes without parentId, or first node)
+    const rootIds = [];
+    for (const node of nodes) {
+        if (!node.parentId) {
+            rootIds.push(node.nodeId);
+        }
+    }
+    // Fallback: if no roots found, use first node
+    if (rootIds.length === 0 && nodes.length > 0) {
+        rootIds.push(nodes[0].nodeId);
+    }
+    const refMap = new Map();
+    const elements = new Map();
+    const hashCounts = new Map();
+    const lines = [];
+    // Structural/invisible roles — skip the node itself but recurse into children
+    const SKIP_ROLES = new Set([
+        'none', 'generic', 'InlineTextBox', 'LineBreak',
+        'StaticText', 'RootWebArea', 'WebArea',
+    ]);
+    function walk(nodeId, depth) {
+        const node = nodeMap.get(nodeId);
+        if (!node)
+            return;
+        // Ignored nodes: still recurse into children (Chrome marks structural
+        // nodes like <html>/<body> as ignored while their children are not)
+        if (node.ignored) {
+            if (node.childIds) {
+                for (const childId of node.childIds) {
+                    walk(childId, depth);
+                }
+            }
+            return;
+        }
+        const role = node.role?.value;
+        if (!role || SKIP_ROLES.has(role)) {
+            // No role or structural role — recurse into children at same depth
+            if (node.childIds) {
+                for (const childId of node.childIds) {
+                    walk(childId, depth);
+                }
+            }
+            return;
+        }
+        const name = node.name?.value || '';
+        const value = node.value?.value;
+        const indent = '  '.repeat(depth);
+        // Determine if this element gets a ref
+        const needsRef = INTERACTIVE_ROLES.has(role) || (name && role !== 'text');
+        let refStr = '';
+        if (needsRef) {
+            const baseHash = stableHash(role, name);
+            const count = hashCounts.get(baseHash) || 0;
+            hashCounts.set(baseHash, count + 1);
+            const refId = count === 0 ? baseHash : `${baseHash}_${count}`;
+            refMap.set(refId, { role, name, backendNodeId: node.backendDOMNodeId });
+            elements.set(refId, { ref: refId, role, name, value });
+            refStr = ` [ref=${refId}]`;
+        }
+        const nameStr = name ? ` "${name}"` : '';
+        const valueStr = value !== undefined ? ` [value="${value}"]` : '';
+        // Check if node has visible children (not just StaticText/InlineTextBox)
+        const hasVisibleChildren = node.childIds?.some((cid) => {
+            const child = nodeMap.get(cid);
+            if (!child)
+                return false;
+            if (child.ignored)
+                return child.childIds?.length ? true : false;
+            const cRole = child.role?.value;
+            return cRole && !SKIP_ROLES.has(cRole);
+        }) ?? false;
+        const colon = hasVisibleChildren ? ':' : '';
+        lines.push(`${indent}- ${role}${nameStr}${refStr}${valueStr}${colon}`);
+        if (node.childIds) {
+            for (const childId of node.childIds) {
+                walk(childId, depth + 1);
+            }
+        }
+    }
+    for (const rootId of rootIds) {
+        walk(rootId, 0);
+    }
+    return {
+        snapshot: lines.length > 0 ? lines.join('\n') : '(empty page)',
+        refMap,
+        elements,
+    };
+}
+//# sourceMappingURL=cdp-snapshot.js.map

package/dist/drivers/cdp-snapshot.js.map

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