@tangle-network/browser-agent-driver 0.6.0

package/dist/drivers/snapshot.js

@@ -0,0 +1,354 @@
+/**
+ * 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.
+ */
+function diffSnapshots(prev, curr) {
+    const added = [];
+    const removed = [];
+    const changed = [];
+    for (const [ref, el] of curr) {
+        const prevEl = prev.get(ref);
+        if (!prevEl) {
+            added.push(`+ ${el.role} "${el.name}" [ref=${ref}]`);
+        }
+        else if (prevEl.value !== el.value) {
+            changed.push(`~ ${el.role} "${el.name}" [ref=${ref}] value: "${prevEl.value ?? ''}" → "${el.value ?? ''}"`);
+        }
+    }
+    for (const [ref, el] of prev) {
+        if (!curr.has(ref)) {
+            removed.push(`- ${el.role} "${el.name}" [ref=${ref}]`);
+        }
+    }
+    return { added, removed, changed, unchangedCount: curr.size - added.length - changed.length };
+}
+/** Format a SnapshotDiff as compact text for brain injection */
+function formatDiff(diff) {
+    const lines = [];
+    if (diff.added.length)
+        lines.push('ADDED:', ...diff.added);
+    if (diff.removed.length)
+        lines.push('REMOVED:', ...diff.removed);
+    if (diff.changed.length)
+        lines.push('CHANGED:', ...diff.changed);
+    lines.push(`(${diff.unchangedCount} elements unchanged)`);
+    return lines.join('\n');
+}
+export const INTERACTIVE_ROLES = new Set([
+    'button', 'link', 'textbox', 'checkbox', 'radio',
+    'combobox', 'listbox', 'menuitem', 'menuitemcheckbox',
+    'menuitemradio', 'option', 'searchbox', 'slider',
+    'spinbutton', 'switch', 'tab', 'treeitem',
+]);
+/**
+ * Generate a short deterministic hash from role+name.
+ * Produces a 3-4 char hex string (e.g. "b3f", "1a2c").
+ */
+export function stableHash(role, name) {
+    const str = `${role}:${name}`;
+    let h = 0x811c9dc5; // FNV-1a offset basis
+    for (let i = 0; i < str.length; i++) {
+        h ^= str.charCodeAt(i);
+        h = Math.imul(h, 0x01000193); // FNV prime
+    }
+    // Take lower 14 bits -> 0-16383 -> 1-4 hex chars, prefix with role initial
+    const hex = ((h >>> 0) & 0x3fff).toString(16);
+    return `${role[0]}${hex}`;
+}
+export class AriaSnapshotHelper {
+    refMap = new Map();
+    /** Track how many times each base hash has been seen (for duplicate disambiguation) */
+    hashCounts = new Map();
+    /** Previous snapshot's parsed elements for diffing */
+    prevElements = new Map();
+    /** Current snapshot's parsed elements (populated during parseAriaSnapshot) */
+    currElements = new Map();
+    /** Last computed diff (undefined on first observe) */
+    lastDiff;
+    /** Clear refs -- call at the start of each observe() cycle */
+    reset() {
+        this.refMap.clear();
+        this.hashCounts.clear();
+    }
+    /**
+     * 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, elements) {
+        // Save previous elements for diffing
+        this.prevElements = this.currElements;
+        this.currElements = new Map(elements);
+        // Import refs into our refMap
+        for (const [refId, entry] of refMap) {
+            this.refMap.set(refId, { role: entry.role, name: entry.name });
+        }
+        // Compute diff
+        if (this.prevElements.size > 0) {
+            this.lastDiff = diffSnapshots(this.prevElements, this.currElements);
+        }
+        else {
+            this.lastDiff = undefined;
+        }
+    }
+    /**
+     * 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.
+     */
+    async buildSnapshot(page) {
+        const rawSnapshot = await page.locator('body').ariaSnapshot({ timeout: 10_000 })
+            .catch(() => '');
+        if (!rawSnapshot.trim())
+            return '(empty page)';
+        // Save previous elements before parsing new snapshot
+        this.prevElements = this.currElements;
+        this.currElements = new Map();
+        let snapshot = this.parseAriaSnapshot(rawSnapshot);
+        // Compute diff after parsing (currElements is now populated)
+        if (this.prevElements.size > 0) {
+            this.lastDiff = diffSnapshots(this.prevElements, this.currElements);
+        }
+        else {
+            this.lastDiff = undefined;
+        }
+        // Augment with data-testid elements -- helps LLMs identify elements
+        // that have no accessible name (e.g., icon-only buttons)
+        const testIds = await page.evaluate(() => {
+            const INTERACTIVE = new Set(['button', 'input', 'textarea', 'select', 'a']);
+            const elements = document.querySelectorAll('[data-testid]');
+            return Array.from(elements)
+                .filter(el => INTERACTIVE.has(el.tagName.toLowerCase()) || el.getAttribute('role'))
+                .slice(0, 30) // Limit to avoid token bloat
+                .map(el => ({
+                testId: el.getAttribute('data-testid') || '',
+                tag: el.tagName.toLowerCase(),
+                text: (el.textContent || '').trim().slice(0, 40),
+                disabled: el.disabled || false,
+            }));
+        }).catch(() => []);
+        if (testIds.length > 0) {
+            snapshot += '\n\nDATA-TESTID SELECTORS (use [data-testid="..."] as selector):';
+            for (const el of testIds) {
+                const disabled = el.disabled ? ' [disabled]' : '';
+                const text = el.text ? ` "${el.text}"` : '';
+                snapshot += `\n  [data-testid="${el.testId}"] ${el.tag}${text}${disabled}`;
+            }
+        }
+        return snapshot;
+    }
+    /**
+     * 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, selector) {
+        if (selector.startsWith('@')) {
+            const refId = selector.slice(1);
+            const entry = this.refMap.get(refId);
+            if (entry) {
+                const roleLocator = page.getByRole(entry.role, {
+                    name: entry.name,
+                    exact: entry.name.length > 0,
+                });
+                // Suffixed refs (e.g., t31b3_2) represent the Nth duplicate of a role+name combo.
+                // Use nth() to target the correct instance instead of always picking first().
+                const suffixMatch = refId.match(/_(\d+)$/);
+                if (suffixMatch) {
+                    const index = parseInt(suffixMatch[1], 10);
+                    return roleLocator.nth(index);
+                }
+                return roleLocator.first();
+            }
+            // Ref not found in current snapshot -- throw with available refs for
+            // auto-retry or Brain feedback
+            throw new StaleRefError(refId, [...this.refMap.keys()]);
+        }
+        return page.locator(selector).first();
+    }
+    /**
+     * 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]
+     */
+    parseAriaSnapshot(raw) {
+        const lines = raw.split('\n');
+        const result = [];
+        for (const line of lines) {
+            const match = line.match(/^(\s*-\s+)(\w+)(?:\s+"([^"]*)")?(.*)$/);
+            if (!match) {
+                result.push(line);
+                continue;
+            }
+            const [, indent, role, name, rest] = match;
+            if (INTERACTIVE_ROLES.has(role) || (name && role !== 'text')) {
+                const baseHash = stableHash(role, name || '');
+                // Track duplicates: first occurrence gets bare hash, subsequent get _N suffix
+                const count = this.hashCounts.get(baseHash) || 0;
+                this.hashCounts.set(baseHash, count + 1);
+                const refId = count === 0 ? baseHash : `${baseHash}_${count}`;
+                this.refMap.set(refId, { role, name: name || '' });
+                // Extract value for diff tracking
+                const valueMatch = rest.match(/\[value="([^"]*)"\]/);
+                this.currElements.set(refId, {
+                    ref: refId,
+                    role,
+                    name: name || '',
+                    value: valueMatch ? valueMatch[1] : undefined,
+                });
+                const cleanRest = rest.replace(/:$/, '').trim();
+                const colon = rest.trimEnd().endsWith(':') ? ':' : '';
+                const nameStr = name ? ` "${name}"` : '';
+                const refStr = ` [ref=${refId}]`;
+                const propsStr = cleanRest ? ` ${cleanRest}` : '';
+                result.push(`${indent}${role}${nameStr}${refStr}${propsStr}${colon}`);
+            }
+            else {
+                result.push(line);
+            }
+        }
+        return result.join('\n');
+    }
+    /**
+     * Get the diff from the last buildSnapshot() call.
+     * Returns undefined on the first call (no previous snapshot to diff against).
+     */
+    getDiff() {
+        if (!this.lastDiff)
+            return undefined;
+        return formatDiff(this.lastDiff);
+    }
+    /** Get the raw structured diff (for programmatic use) */
+    getRawDiff() {
+        return this.lastDiff;
+    }
+    /**
+     * 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) {
+        const lines = snapshot.split('\n');
+        const compact = [];
+        for (const line of lines) {
+            const match = line.match(/\s*-\s+(\w+)\s+"([^"]*)"?\s*\[ref=(\w+)\](.*)?$/);
+            if (!match)
+                continue;
+            const [, role, name, ref, rest] = match;
+            const valueMatch = rest?.match(/\[value="([^"]*)"\]/);
+            const value = valueMatch ? ` val="${valueMatch[1]}"` : '';
+            compact.push(`@${ref} ${role} "${name}"${value}`);
+        }
+        return compact.join('\n');
+    }
+}
+/**
+ * Typed error for stale ref detection -- allows runner to catch specifically
+ * and auto-retry with a fresh observation.
+ */
+export class StaleRefError extends Error {
+    staleRef;
+    availableRefs;
+    constructor(staleRef, availableRefs) {
+        super(`Ref "@${staleRef}" not found in current snapshot ` +
+            `(available: ${availableRefs.join(', ') || 'none'}). ` +
+            `Use a ref from the CURRENT observation.`);
+        this.name = 'StaleRefError';
+        this.staleRef = staleRef;
+        this.availableRefs = availableRefs;
+    }
+}
+/**
+ * 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 async function dismissOverlays(page) {
+    const result = await page.evaluate(() => {
+        const dialog = document.querySelector('[role="dialog"]');
+        if (dialog) {
+            const closeByLabel = dialog.querySelector('button[aria-label="Close"]');
+            if (closeByLabel) {
+                closeByLabel.click();
+                return 'clicked';
+            }
+            const btns = dialog.querySelectorAll('button');
+            for (const btn of btns) {
+                const text = (btn.textContent || '').toLowerCase().trim();
+                if (text === 'close' || text.includes('cancel') || text.includes('maybe later') || text.includes('dismiss') || text.includes('skip')) {
+                    btn.click();
+                    return 'clicked';
+                }
+            }
+            return 'found'; // Dialog found but no close button -- needs Escape
+        }
+        const overlay = document.querySelector('div.fixed.inset-0[class*="z-"]');
+        if (overlay) {
+            const closeBtn = overlay.querySelector('button[aria-label="Close"]');
+            if (closeBtn) {
+                closeBtn.click();
+                return 'clicked';
+            }
+            return 'found';
+        }
+        const viteOverlay = document.querySelector('vite-error-overlay');
+        if (viteOverlay) {
+            viteOverlay.remove();
+            return 'clicked';
+        }
+        return false;
+    });
+    if (result === 'clicked') {
+        // Close button handled it -- just wait for animation, no Escape needed
+        await page.waitForTimeout(300);
+    }
+    else if (result === 'found') {
+        // Overlay detected but no close button -- try Escape as fallback
+        await page.waitForTimeout(300);
+        await page.keyboard.press('Escape');
+        await page.waitForTimeout(200);
+    }
+    // result === false: no overlay, no action needed
+    return result;
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/drivers/snapshot.js.map

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

package/dist/drivers/types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Driver interface - abstraction over browser automation
+ */
+import type { Action, PageState } from '../types.js';
+export interface ActionResult {
+    success: boolean;
+    error?: string;
+    /** Data returned by the action (e.g., runScript result) */
+    data?: string;
+}
+export interface ResourceBlockingOptions {
+    /** Block image loading (png, jpg, gif, svg, webp, ico, etc.) */
+    blockImages?: boolean;
+    /** Block media loading (video, audio) */
+    blockMedia?: boolean;
+    /** Block analytics/tracking scripts */
+    blockAnalytics?: boolean;
+    /** Custom URL patterns to block (matched via url.includes()) */
+    blockPatterns?: string[];
+}
+export interface Driver {
+    /** Get current page state (DOM snapshot, optionally screenshot) */
+    observe(): Promise<PageState>;
+    /** Execute an action */
+    execute(action: Action): Promise<ActionResult>;
+    /** Get the underlying Playwright page (if available) */
+    getPage?(): import('playwright').Page | undefined;
+    /** Take a screenshot on demand */
+    screenshot?(): Promise<Buffer>;
+    /** Best-effort href inspection for a selector before executing a click */
+    inspectSelectorHref?(selector: string): Promise<string | undefined>;
+    /** Optional run-time diagnostics for startup and browser/session setup */
+    getDiagnostics?(): Record<string, unknown>;
+    /** Close/cleanup the driver */
+    close?(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/drivers/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,gEAAgE;IAChE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yCAAyC;IACzC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uCAAuC;IACvC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,MAAM;IACrB,mEAAmE;IACnE,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IAE9B,wBAAwB;IACxB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE/C,wDAAwD;IACxD,OAAO,CAAC,IAAI,OAAO,YAAY,EAAE,IAAI,GAAG,SAAS,CAAC;IAElD,kCAAkC;IAClC,UAAU,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/B,0EAA0E;IAC1E,mBAAmB,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAEpE,0EAA0E;IAC1E,cAAc,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE3C,+BAA+B;IAC/B,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB"}

package/dist/drivers/types.js

@@ -0,0 +1,5 @@
+/**
+ * Driver interface - abstraction over browser automation
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/drivers/types.js.map

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

package/dist/env-loader.d.ts

@@ -0,0 +1,2 @@
+export declare function loadLocalEnvFiles(startDir: string, files?: string[]): void;
+//# sourceMappingURL=env-loader.d.ts.map

package/dist/env-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-loader.d.ts","sourceRoot":"","sources":["../src/env-loader.ts"],"names":[],"mappings":"AAGA,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,WAAyB,GAAG,IAAI,CAWxF"}

package/dist/env-loader.js

@@ -0,0 +1,35 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+export function loadLocalEnvFiles(startDir, files = ['.env.local', '.env']) {
+    for (const file of files) {
+        const filePath = path.join(startDir, file);
+        if (!fs.existsSync(filePath))
+            continue;
+        const parsed = parseEnvFile(fs.readFileSync(filePath, 'utf-8'));
+        for (const [key, value] of Object.entries(parsed)) {
+            if (!(key in process.env)) {
+                process.env[key] = value;
+            }
+        }
+    }
+}
+function parseEnvFile(contents) {
+    const out = {};
+    for (const rawLine of contents.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (!line || line.startsWith('#'))
+            continue;
+        const match = line.match(/^([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)$/);
+        if (!match)
+            continue;
+        const key = match[1];
+        let value = match[2] ?? '';
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        out[key] = value;
+    }
+    return out;
+}
+//# sourceMappingURL=env-loader.js.map

package/dist/env-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-loader.js","sourceRoot":"","sources":["../src/env-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,KAAK,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC;IAChF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,SAAS;QACvC,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;QAChE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB;IACpC,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAClE,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3B,IACE,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC9C,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAC9C,CAAC;YACD,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/formatters/slack.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Slack payload formatter for WebhookSink.
+ *
+ * Transforms WebhookPayload into Slack Block Kit format for incoming webhooks.
+ * Use with: new WebhookSink({ url: SLACK_WEBHOOK_URL, formatPayload: slackFormatter })
+ */
+import type { WebhookPayload } from '../artifacts/webhook-sink.js';
+interface SlackBlock {
+    type: string;
+    text?: {
+        type: string;
+        text: string;
+        emoji?: boolean;
+    };
+    elements?: Array<{
+        type: string;
+        text: string;
+        emoji?: boolean;
+    }>;
+    fields?: Array<{
+        type: string;
+        text: string;
+    }>;
+}
+interface SlackMessage {
+    text: string;
+    blocks?: SlackBlock[];
+}
+/**
+ * Format a WebhookPayload as a Slack Block Kit message.
+ *
+ * - `artifact` events: compact one-liner with test ID and artifact type
+ * - `suite:complete` events: rich summary with pass/fail counts and test list
+ */
+export declare function slackFormatter(payload: WebhookPayload): SlackMessage;
+export {};
+//# sourceMappingURL=slack.d.ts.map

package/dist/formatters/slack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.d.ts","sourceRoot":"","sources":["../../src/formatters/slack.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACvD,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAClE,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,YAAY,CAMpE"}

package/dist/formatters/slack.js

@@ -0,0 +1,97 @@
+/**
+ * Slack payload formatter for WebhookSink.
+ *
+ * Transforms WebhookPayload into Slack Block Kit format for incoming webhooks.
+ * Use with: new WebhookSink({ url: SLACK_WEBHOOK_URL, formatPayload: slackFormatter })
+ */
+/**
+ * Format a WebhookPayload as a Slack Block Kit message.
+ *
+ * - `artifact` events: compact one-liner with test ID and artifact type
+ * - `suite:complete` events: rich summary with pass/fail counts and test list
+ */
+export function slackFormatter(payload) {
+    if (payload.event === 'suite:complete') {
+        return formatSuiteComplete(payload);
+    }
+    return formatArtifact(payload);
+}
+function formatSuiteComplete(payload) {
+    const { manifest, summary } = payload;
+    const testIds = [...new Set(manifest.map((e) => e.testId).filter((id) => id !== 'suite'))];
+    const hasSummary = summary && summary.total > 0;
+    const passed = summary?.passed ?? 0;
+    const failed = summary?.failed ?? 0;
+    const total = summary?.total ?? testIds.length;
+    const allPassed = failed === 0 && passed > 0;
+    const icon = allPassed ? ':white_check_mark:' : ':x:';
+    const headline = allPassed
+        ? `${icon} All ${total} tests passed`
+        : `${icon} ${passed}/${total} passed, ${failed} failed`;
+    const blocks = [
+        {
+            type: 'header',
+            text: { type: 'plain_text', text: 'browser-agent-driver', emoji: true },
+        },
+        {
+            type: 'section',
+            text: { type: 'mrkdwn', text: headline },
+        },
+    ];
+    if (hasSummary) {
+        blocks.push({
+            type: 'section',
+            fields: [
+                { type: 'mrkdwn', text: `*Passed:* ${passed}` },
+                { type: 'mrkdwn', text: `*Failed:* ${failed}` },
+                { type: 'mrkdwn', text: `*Total:* ${total}` },
+            ],
+        });
+    }
+    // List test IDs
+    if (testIds.length > 0 && testIds.length <= 20) {
+        const testList = testIds.map((id) => `\`${id}\``).join(', ');
+        blocks.push({
+            type: 'section',
+            text: { type: 'mrkdwn', text: `*Tests:* ${testList}` },
+        });
+    }
+    // Artifacts count
+    const screenshotCount = manifest.filter((e) => e.type === 'screenshot').length;
+    const reportCount = manifest.filter((e) => e.type.startsWith('report-')).length;
+    if (screenshotCount > 0 || reportCount > 0) {
+        const parts = [];
+        if (reportCount > 0)
+            parts.push(`${reportCount} reports`);
+        if (screenshotCount > 0)
+            parts.push(`${screenshotCount} screenshots`);
+        blocks.push({
+            type: 'context',
+            elements: [{ type: 'mrkdwn', text: `Artifacts: ${parts.join(', ')}` }],
+        });
+    }
+    return {
+        text: headline.replace(/:[a-z_]+:/g, '').trim(), // fallback text without emoji
+        blocks,
+    };
+}
+function formatArtifact(payload) {
+    const text = `*${payload.type}* \`${payload.name}\` for test \`${payload.testId}\` (${formatBytes(payload.sizeBytes)})`;
+    return {
+        text: `${payload.type}: ${payload.name} for ${payload.testId}`,
+        blocks: [
+            {
+                type: 'section',
+                text: { type: 'mrkdwn', text },
+            },
+        ],
+    };
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes}B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)}KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}
+//# sourceMappingURL=slack.js.map

package/dist/formatters/slack.js.map

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