@tangle-network/browser-agent-driver 0.6.0

package/dist/drivers/playwright.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Playwright driver — accessibility tree + screenshot observation
+ * with ref-based element resolution and full browser action vocabulary.
+ *
+ * Uses AriaSnapshotHelper for consistent a11y tree snapshots across all drivers.
+ * Optionally uses CDP (Chrome DevTools Protocol) for faster observe() calls:
+ * - Accessibility.getFullAXTree instead of ariaSnapshot() (no YAML serialize→parse)
+ * - Runtime.evaluate for batched page metadata (URL + title + testids in one call)
+ * - No 1-second hard sleep (uses lifecycle events only)
+ */
+import type { Page } from 'playwright';
+import type { Driver, ActionResult, ResourceBlockingOptions } from './types.js';
+import type { Action, PageState } from '../types.js';
+/** Phase-level timing breakdown for observe() */
+export interface ObserveTiming {
+    /** Total observe() time in ms */
+    totalMs: number;
+    /** Time waiting for page load state */
+    waitForLoadMs: number;
+    /** Time building accessibility tree snapshot */
+    snapshotMs: number;
+    /** Time getting page metadata (URL, title, testids) */
+    metadataMs: number;
+    /** Time capturing screenshot (0 if disabled) */
+    screenshotMs: number;
+    /** Whether CDP fast-path was used */
+    usedCdp: boolean;
+    /** Size of snapshot in characters */
+    snapshotSize: number;
+    /** Number of refs in snapshot */
+    refCount: number;
+}
+export interface PlaywrightDriverOptions {
+    /** Action timeout in ms */
+    timeout?: number;
+    /** Capture screenshots on each observe (default: true for vision) */
+    captureScreenshots?: boolean;
+    /** Screenshot quality (1-100, default 50) */
+    screenshotQuality?: number;
+    /** Disable CDP fast-path (fall back to Playwright for everything) */
+    disableCdp?: boolean;
+}
+export declare class PlaywrightDriver implements Driver {
+    private page;
+    private options;
+    private snapshot;
+    private cdpSession;
+    private cdpFailed;
+    private lastTiming;
+    constructor(page: Page, options?: PlaywrightDriverOptions);
+    /** Get phase-level timing from the last observe() call */
+    getLastTiming(): ObserveTiming | undefined;
+    getPage(): Page;
+    inspectSelectorHref(selector: string): Promise<string | undefined>;
+    private adoptPage;
+    /**
+     * Set up resource blocking to speed up page loads by aborting unnecessary requests.
+     * Call before first navigation for best results.
+     */
+    setupResourceBlocking(options: ResourceBlockingOptions): Promise<void>;
+    /**
+     * Lazy-init a CDP session. Returns null if CDP is unavailable
+     * (non-Chromium browser) or if a previous attempt failed.
+     */
+    private ensureCdpSession;
+    observe(): Promise<PageState>;
+    /**
+     * Fast CDP observation path — no 1s sleep, batched calls.
+     */
+    private observeCdp;
+    /**
+     * Original Playwright observation path — used as fallback when CDP is unavailable.
+     */
+    private observePlaywright;
+    screenshot(): Promise<Buffer>;
+    close(): Promise<void>;
+    /**
+     * Execute an action first. If it fails and a blocking overlay is detected,
+     * dismiss it and retry once.
+     */
+    private withOverlayRecovery;
+    execute(action: Action): Promise<ActionResult>;
+}
+//# sourceMappingURL=playwright.d.ts.map

package/dist/drivers/playwright.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright.d.ts","sourceRoot":"","sources":["../../src/drivers/playwright.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAUrD,iDAAiD;AACjD,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,6CAA6C;IAC7C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qEAAqE;IACrE,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,gBAAiB,YAAW,MAAM;IAO3C,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,OAAO;IAPjB,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAA4B;gBAGpC,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,uBAA4B;IAG/C,0DAA0D;IAC1D,aAAa,IAAI,aAAa,GAAG,SAAS;IAI1C,OAAO,IAAI,IAAI;IAIT,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;YAS1D,SAAS;IAWvB;;;OAGG;IACG,qBAAqB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuC5E;;;OAGG;YACW,gBAAgB;IAcxB,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC;IAuCnC;;OAEG;YACW,UAAU;IA0DxB;;OAEG;YACW,iBAAiB;IAuCzB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B;;;OAGG;YACW,mBAAmB;IAU3B,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAsIrD"}

package/dist/drivers/playwright.js

@@ -0,0 +1,385 @@
+/**
+ * Playwright driver — accessibility tree + screenshot observation
+ * with ref-based element resolution and full browser action vocabulary.
+ *
+ * Uses AriaSnapshotHelper for consistent a11y tree snapshots across all drivers.
+ * Optionally uses CDP (Chrome DevTools Protocol) for faster observe() calls:
+ * - Accessibility.getFullAXTree instead of ariaSnapshot() (no YAML serialize→parse)
+ * - Runtime.evaluate for batched page metadata (URL + title + testids in one call)
+ * - No 1-second hard sleep (uses lifecycle events only)
+ */
+import { AriaSnapshotHelper, dismissOverlays } from './snapshot.js';
+import { ANALYTICS_PATTERNS, IMAGE_PATTERNS, MEDIA_PATTERNS } from './block-patterns.js';
+import { buildCdpSnapshot } from './cdp-snapshot.js';
+import { getPageMetadata } from './cdp-page-state.js';
+function isPointerInterceptError(error) {
+    return /intercepts pointer events|subtree intercepts pointer events|not receiving pointer events/i.test(error);
+}
+export class PlaywrightDriver {
+    page;
+    options;
+    snapshot = new AriaSnapshotHelper();
+    cdpSession = null;
+    cdpFailed = false;
+    lastTiming;
+    constructor(page, options = {}) {
+        this.page = page;
+        this.options = options;
+    }
+    /** Get phase-level timing from the last observe() call */
+    getLastTiming() {
+        return this.lastTiming;
+    }
+    getPage() {
+        return this.page;
+    }
+    async inspectSelectorHref(selector) {
+        const locator = this.snapshot.resolveLocator(this.page, selector);
+        return locator.evaluate((node) => {
+            const element = node;
+            const anchor = element?.closest('a[href]');
+            return anchor?.href || undefined;
+        }).catch(() => undefined);
+    }
+    async adoptPage(nextPage) {
+        if (this.page === nextPage)
+            return;
+        if (this.cdpSession) {
+            await this.cdpSession.detach().catch(() => { });
+        }
+        this.page = nextPage;
+        this.cdpSession = null;
+        this.cdpFailed = false;
+        this.snapshot.reset();
+    }
+    /**
+     * Set up resource blocking to speed up page loads by aborting unnecessary requests.
+     * Call before first navigation for best results.
+     */
+    async setupResourceBlocking(options) {
+        const urlPatterns = [];
+        if (options.blockImages)
+            urlPatterns.push(...IMAGE_PATTERNS);
+        if (options.blockMedia)
+            urlPatterns.push(...MEDIA_PATTERNS);
+        if (options.blockAnalytics)
+            urlPatterns.push(...ANALYTICS_PATTERNS);
+        if (options.blockPatterns)
+            urlPatterns.push(...options.blockPatterns);
+        if (urlPatterns.length === 0)
+            return;
+        const blockImages = options.blockImages ?? false;
+        const blockMedia = options.blockMedia ?? false;
+        await this.page.route('**/*', async (route) => {
+            const url = route.request().url();
+            const type = route.request().resourceType();
+            // Fast path: check resource type
+            if (blockImages && type === 'image') {
+                await route.abort();
+                return;
+            }
+            if (blockMedia && type === 'media') {
+                await route.abort();
+                return;
+            }
+            // URL pattern matching
+            for (const pattern of urlPatterns) {
+                if (url.includes(pattern)) {
+                    await route.abort();
+                    return;
+                }
+            }
+            await route.continue();
+        });
+    }
+    /**
+     * Lazy-init a CDP session. Returns null if CDP is unavailable
+     * (non-Chromium browser) or if a previous attempt failed.
+     */
+    async ensureCdpSession() {
+        if (this.options.disableCdp || this.cdpFailed)
+            return null;
+        if (this.cdpSession)
+            return this.cdpSession;
+        try {
+            this.cdpSession = await this.page.context().newCDPSession(this.page);
+            return this.cdpSession;
+        }
+        catch {
+            // Non-Chromium browser or CDP not available
+            this.cdpFailed = true;
+            return null;
+        }
+    }
+    async observe() {
+        const observeStart = performance.now();
+        const captureScreenshot = this.options.captureScreenshots ?? true;
+        const quality = this.options.screenshotQuality ?? 50;
+        const waitStart = performance.now();
+        // Cap load state wait at 10s — heavy JS sites (AliExpress) can stall
+        // domcontentloaded for 30s+. The page usually has usable DOM much earlier.
+        await Promise.race([
+            this.page.waitForLoadState('domcontentloaded').catch(() => { }),
+            new Promise(resolve => setTimeout(resolve, 10_000)),
+        ]);
+        const waitForLoadMs = performance.now() - waitStart;
+        this.snapshot.reset();
+        const cdp = await this.ensureCdpSession();
+        if (cdp) {
+            try {
+                const result = await this.observeCdp(cdp, captureScreenshot, quality);
+                this.lastTiming.waitForLoadMs = waitForLoadMs;
+                this.lastTiming.totalMs = performance.now() - observeStart;
+                return result;
+            }
+            catch {
+                // CDP call failed — detach and fall back to Playwright for this turn
+                this.cdpSession = null;
+                this.cdpFailed = false; // Allow retry next turn (transient failure)
+                this.snapshot.reset(); // Reset refs since CDP partially populated them
+            }
+        }
+        // Fallback: original Playwright path (with 1s sleep)
+        const result = await this.observePlaywright(captureScreenshot, quality);
+        this.lastTiming.waitForLoadMs = waitForLoadMs;
+        this.lastTiming.totalMs = performance.now() - observeStart;
+        return result;
+    }
+    /**
+     * Fast CDP observation path — no 1s sleep, batched calls.
+     */
+    async observeCdp(cdp, captureScreenshot, quality) {
+        // Parallel: get page metadata + build AX tree snapshot
+        const snapshotStart = performance.now();
+        const [metadata, cdpResult] = await Promise.all([
+            getPageMetadata(cdp),
+            buildCdpSnapshot(cdp),
+        ]);
+        const snapshotMs = performance.now() - snapshotStart;
+        // Import refs into the snapshot helper (for resolveLocator + getDiff)
+        this.snapshot.importCdpRefs(cdpResult.refMap, cdpResult.elements);
+        // Append testid selectors to snapshot (same as Playwright path)
+        let snapshotText = cdpResult.snapshot;
+        if (metadata.testIds.length > 0) {
+            snapshotText += '\n\nDATA-TESTID SELECTORS (use [data-testid="..."] as selector):';
+            for (const el of metadata.testIds) {
+                const disabled = el.disabled ? ' [disabled]' : '';
+                const text = el.text ? ` "${el.text}"` : '';
+                snapshotText += `\n  [data-testid="${el.testId}"] ${el.tag}${text}${disabled}`;
+            }
+        }
+        // Screenshot still via Playwright (viewport compositing)
+        const ssStart = performance.now();
+        let screenshot;
+        if (captureScreenshot) {
+            const buf = await this.page.screenshot({ type: 'jpeg', quality });
+            screenshot = buf.toString('base64');
+        }
+        const screenshotMs = performance.now() - ssStart;
+        const snapshotDiff = this.snapshot.getDiff();
+        this.lastTiming = {
+            totalMs: 0, // filled by observe()
+            waitForLoadMs: 0, // filled by observe()
+            snapshotMs,
+            metadataMs: snapshotMs, // metadata fetched in parallel with snapshot
+            screenshotMs,
+            usedCdp: true,
+            snapshotSize: snapshotText.length,
+            refCount: cdpResult.refMap.size,
+        };
+        return {
+            url: metadata.url,
+            title: metadata.title,
+            snapshot: snapshotText,
+            screenshot,
+            snapshotDiff,
+        };
+    }
+    /**
+     * Original Playwright observation path — used as fallback when CDP is unavailable.
+     */
+    async observePlaywright(captureScreenshot, quality) {
+        await this.page.waitForTimeout(1000);
+        const snapshotStart = performance.now();
+        const [url, title, snapshotText] = await Promise.all([
+            this.page.url(),
+            this.page.title(),
+            this.snapshot.buildSnapshot(this.page),
+        ]);
+        const snapshotMs = performance.now() - snapshotStart;
+        const ssStart = performance.now();
+        let screenshot;
+        if (captureScreenshot) {
+            const buf = await this.page.screenshot({ type: 'jpeg', quality });
+            screenshot = buf.toString('base64');
+        }
+        const screenshotMs = performance.now() - ssStart;
+        const snapshotDiff = this.snapshot.getDiff();
+        const refMatches = snapshotText.match(/\[ref=\w+\]/g);
+        this.lastTiming = {
+            totalMs: 0, // filled by observe()
+            waitForLoadMs: 0, // filled by observe()
+            snapshotMs,
+            metadataMs: snapshotMs, // metadata fetched in parallel with snapshot
+            screenshotMs,
+            usedCdp: false,
+            snapshotSize: snapshotText.length,
+            refCount: refMatches?.length ?? 0,
+        };
+        return { url, title, snapshot: snapshotText, screenshot, snapshotDiff };
+    }
+    async screenshot() {
+        return this.page.screenshot({ type: 'jpeg', quality: this.options.screenshotQuality ?? 70 });
+    }
+    async close() {
+        if (this.cdpSession) {
+            await this.cdpSession.detach().catch(() => { });
+            this.cdpSession = null;
+        }
+    }
+    /**
+     * Execute an action first. If it fails and a blocking overlay is detected,
+     * dismiss it and retry once.
+     */
+    async withOverlayRecovery(operation) {
+        try {
+            return await operation();
+        }
+        catch (firstError) {
+            const dismissed = await dismissOverlays(this.page);
+            if (!dismissed)
+                throw firstError;
+            return operation();
+        }
+    }
+    async execute(action) {
+        const timeout = this.options.timeout ?? 30000;
+        try {
+            switch (action.action) {
+                case 'click': {
+                    const locator = this.snapshot.resolveLocator(this.page, action.selector);
+                    const popupPromise = this.page.context()
+                        .waitForEvent('page', { timeout: Math.min(timeout, 2_000) })
+                        .catch(() => null);
+                    try {
+                        await this.withOverlayRecovery(async () => {
+                            await locator.click({ timeout });
+                        });
+                    }
+                    catch (err) {
+                        const message = err instanceof Error ? err.message : String(err);
+                        if (!isPointerInterceptError(message))
+                            throw err;
+                        // Fallback for sticky overlays/sidebars that still intercept pointer events.
+                        await locator.click({ timeout, force: true });
+                    }
+                    const popupPage = await popupPromise;
+                    if (popupPage && !popupPage.isClosed()) {
+                        await popupPage.waitForLoadState('domcontentloaded').catch(() => { });
+                        await this.adoptPage(popupPage);
+                    }
+                    return { success: true };
+                }
+                case 'type': {
+                    const locator = this.snapshot.resolveLocator(this.page, action.selector);
+                    try {
+                        await this.withOverlayRecovery(async () => {
+                            await locator.click({ timeout });
+                            await locator.fill(action.text, { timeout });
+                            await locator.evaluate((el) => {
+                                el.dispatchEvent(new Event('input', { bubbles: true }));
+                                el.dispatchEvent(new Event('change', { bubbles: true }));
+                            });
+                        });
+                    }
+                    catch (err) {
+                        const message = err instanceof Error ? err.message : String(err);
+                        if (!isPointerInterceptError(message))
+                            throw err;
+                        await locator.click({ timeout, force: true });
+                        await locator.fill(action.text, { timeout });
+                        await locator.evaluate((el) => {
+                            el.dispatchEvent(new Event('input', { bubbles: true }));
+                            el.dispatchEvent(new Event('change', { bubbles: true }));
+                        });
+                    }
+                    return { success: true };
+                }
+                case 'press': {
+                    const locator = this.snapshot.resolveLocator(this.page, action.selector);
+                    await this.withOverlayRecovery(async () => {
+                        await locator.press(action.key, { timeout });
+                    });
+                    return { success: true };
+                }
+                case 'hover': {
+                    const locator = this.snapshot.resolveLocator(this.page, action.selector);
+                    await locator.hover({ timeout });
+                    return { success: true };
+                }
+                case 'select': {
+                    const locator = this.snapshot.resolveLocator(this.page, action.selector);
+                    await locator.selectOption(action.value, { timeout });
+                    return { success: true };
+                }
+                case 'scroll': {
+                    const delta = action.direction === 'down'
+                        ? (action.amount ?? 500)
+                        : -(action.amount ?? 500);
+                    if (action.selector) {
+                        // Scroll a specific container element
+                        const container = this.snapshot.resolveLocator(this.page, action.selector);
+                        await container.evaluate((el, d) => { el.scrollBy(0, d); }, delta);
+                    }
+                    else {
+                        await this.page.mouse.wheel(0, delta);
+                    }
+                    return { success: true };
+                }
+                case 'navigate': {
+                    // Cap navigation at 15s — heavy JS sites (AliExpress, etc.) can stall domcontentloaded
+                    // for 40s+. Better to proceed with partial DOM than timeout the whole case.
+                    const navTimeout = Math.min(timeout, 15_000);
+                    try {
+                        await this.page.goto(action.url, { timeout: navTimeout, waitUntil: 'domcontentloaded' });
+                    }
+                    catch (navErr) {
+                        // If domcontentloaded timed out but the page has started loading,
+                        // proceed — the agent can still interact with whatever is in the DOM.
+                        const currentUrl = this.page.url();
+                        if (currentUrl !== 'about:blank' && currentUrl !== '') {
+                            // Page partially loaded — continue with what we have
+                            return { success: true };
+                        }
+                        throw navErr;
+                    }
+                    return { success: true };
+                }
+                case 'wait':
+                    await this.page.waitForTimeout(action.ms);
+                    return { success: true };
+                case 'runScript': {
+                    const scriptResult = await this.page.evaluate(action.script);
+                    const stringified = typeof scriptResult === 'string'
+                        ? scriptResult
+                        : JSON.stringify(scriptResult, null, 2);
+                    return { success: true, error: undefined, data: stringified };
+                }
+                case 'evaluate':
+                case 'verifyPreview':
+                    // Handled by the runner — the driver just acknowledges it.
+                    return { success: true };
+                case 'complete':
+                case 'abort':
+                    return { success: true };
+                default:
+                    return { success: false, error: `Unknown action: ${action.action}` };
+            }
+        }
+        catch (err) {
+            const error = err instanceof Error ? err.message : String(err);
+            return { success: false, error };
+        }
+    }
+}
+//# sourceMappingURL=playwright.js.map

package/dist/drivers/playwright.js.map

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

package/dist/drivers/snapshot.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Shared accessibility tree snapshot helper.
+ *
+ * Uses Playwright's `locator.ariaSnapshot()` to produce a YAML-like tree,
+ * assigns STABLE ref IDs to interactive elements (deterministic hash of
+ * role+name), and resolves @ref selectors back to Playwright locators via
+ * getByRole().
+ *
+ * Stable refs mean the same element (e.g. button "Send") gets the SAME ref ID
+ * across observations. Only elements that truly disappear produce invalid refs.
+ * Duplicates (multiple elements with same role+name) get index suffixes.
+ *
+ * Used by PlaywrightDriver.
+ */
+import type { Page, Locator } from 'playwright';
+/** Parsed element with value for diffing */
+export interface ParsedElement {
+    ref: string;
+    role: string;
+    name: string;
+    value?: string;
+}
+/** Structured diff between two snapshots */
+export interface SnapshotDiff {
+    added: string[];
+    removed: string[];
+    changed: string[];
+    unchangedCount: number;
+}
+export declare const INTERACTIVE_ROLES: Set<string>;
+/**
+ * Generate a short deterministic hash from role+name.
+ * Produces a 3-4 char hex string (e.g. "b3f", "1a2c").
+ */
+export declare function stableHash(role: string, name: string): string;
+export declare class AriaSnapshotHelper {
+    private refMap;
+    /** Track how many times each base hash has been seen (for duplicate disambiguation) */
+    private hashCounts;
+    /** Previous snapshot's parsed elements for diffing */
+    private prevElements;
+    /** Current snapshot's parsed elements (populated during parseAriaSnapshot) */
+    private currElements;
+    /** Last computed diff (undefined on first observe) */
+    private lastDiff;
+    /** Clear refs -- call at the start of each observe() cycle */
+    reset(): void;
+    /**
+     * Import refs and elements from an external source (e.g., CDP snapshot).
+     *
+     * Populates the internal refMap and currElements so that resolveLocator()
+     * and getDiff() work identically to the Playwright ariaSnapshot path.
+     */
+    importCdpRefs(refMap: Map<string, {
+        role: string;
+        name: string;
+    }>, elements: Map<string, ParsedElement>): void;
+    /**
+     * Build an accessibility tree snapshot with stable ref IDs.
+     *
+     * Calls `page.locator('body').ariaSnapshot()` and parses the YAML output,
+     * assigning deterministic `[ref=XX]` to interactive/named elements.
+     */
+    buildSnapshot(page: Page): Promise<string>;
+    /**
+     * Resolve a selector to a Playwright Locator.
+     *
+     * - `@b3f` -> resolved from ref map via getByRole()
+     * - Standard selectors (CSS, text=, role=, [data-testid=...]) -> page.locator()
+     */
+    resolveLocator(page: Page, selector: string): Locator;
+    /**
+     * Parse Playwright's ARIA snapshot YAML and assign stable ref IDs.
+     *
+     * Ref IDs are deterministic hashes of role+name, so the same element gets
+     * the same ref across observations. Duplicates get index suffixes (_1, _2).
+     *
+     * Input:
+     *   - button "Sign in"
+     *   - textbox "Email" [value=""]
+     *   - list "Nav":
+     *     - link "Home"
+     *
+     * Output:
+     *   - button "Sign in" [ref=b2a1]
+     *   - textbox "Email" [ref=t3f0] [value=""]
+     *   - list "Nav" [ref=l1b2]:
+     *     - link "Home" [ref=la3c]
+     */
+    private parseAriaSnapshot;
+    /**
+     * Get the diff from the last buildSnapshot() call.
+     * Returns undefined on the first call (no previous snapshot to diff against).
+     */
+    getDiff(): string | undefined;
+    /** Get the raw structured diff (for programmatic use) */
+    getRawDiff(): SnapshotDiff | undefined;
+    /**
+     * Format a snapshot in compact form: one line per element, ref-first,
+     * flat (no nesting), ~50-60% fewer tokens.
+     *
+     * Full format:
+     *   - button "Sign in" [ref=b2a1]
+     *   - textbox "Email" [ref=t3f0] [value=""]
+     *   - list "Nav" [ref=l1b2]:
+     *     - link "Home" [ref=la3c]
+     *
+     * Compact format:
+     *   @b2a1 button "Sign in"
+     *   @t3f0 textbox "Email" val=""
+     *   @l1b2 list "Nav"
+     *   @la3c link "Home"
+     */
+    static formatCompact(snapshot: string): string;
+}
+/**
+ * Typed error for stale ref detection -- allows runner to catch specifically
+ * and auto-retry with a fresh observation.
+ */
+export declare class StaleRefError extends Error {
+    readonly staleRef: string;
+    readonly availableRefs: string[];
+    constructor(staleRef: string, availableRefs: string[]);
+}
+/**
+ * Dismiss blocking overlays (dialogs, modals, Vite errors).
+ * Shared between drivers that operate on a Playwright page.
+ *
+ * Returns 'clicked' if a close button was found and clicked,
+ * 'found' if an overlay exists but no close button was found (Escape pressed),
+ * or false if no overlay was detected.
+ */
+export declare function dismissOverlays(page: Page): Promise<'clicked' | 'found' | false>;
+//# sourceMappingURL=snapshot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/drivers/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAOhD,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAqCD,eAAO,MAAM,iBAAiB,aAK5B,CAAC;AAEH;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAU7D;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAA+B;IAC7C,uFAAuF;IACvF,OAAO,CAAC,UAAU,CAA6B;IAE/C,sDAAsD;IACtD,OAAO,CAAC,YAAY,CAAoC;IACxD,8EAA8E;IAC9E,OAAO,CAAC,YAAY,CAAoC;IACxD,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAA2B;IAE3C,8DAA8D;IAC9D,KAAK,IAAI,IAAI;IAKb;;;;;OAKG;IACH,aAAa,CACX,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,EACnD,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GACnC,IAAI;IAkBP;;;;;OAKG;IACG,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IA+ChD;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IA6BrD;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,iBAAiB;IA8CzB;;;OAGG;IACH,OAAO,IAAI,MAAM,GAAG,SAAS;IAK7B,yDAAyD;IACzD,UAAU,IAAI,YAAY,GAAG,SAAS;IAItC;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;CAgB/C;AAED;;;GAGG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;gBAErB,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE;CAUtD;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,SAAS,GAAG,OAAO,GAAG,KAAK,CAAC,CAsCtF"}