@xoxoai/checkmate 0.4.28 → 0.5.1

package/dist/drivers/web/session.js

@@ -0,0 +1,130 @@
+import { BrowserScreenshotService } from './tools/screenshot-service.js';
+import { BrowserToolRuntime, createBrowserTools } from './tools/tool.js';
+import { SnapshotService } from './tools/snapshot-service.js';
+const WEB_INSTRUCTIONS = [
+    'Browser tools operate on the active browser tab/page. Tabs and popups opened by browser actions become active automatically.',
+    "Use 'browser_list_tabs', 'browser_select_tab', and 'browser_close_tab' to inspect, switch, or close browser tabs and popups.",
+    "If you cannot find elements, call 'browser_snapshot' to fetch the latest full snapshot of the active page.",
+    "For JavaScript alert, confirm, or prompt dialogs, call 'browser_set_dialog_response' immediately before the browser action that opens the dialog when the step needs OK, Cancel, or prompt text. Unarmed dialogs are dismissed automatically.",
+    "To verify backend behavior, call 'browser_network_requests' after a browser action to see the API calls that action triggered. Each call only covers the browser action immediately before it. Use 'browser_network_request' with a request's number to inspect its headers or read its request/response body.",
+];
+export async function createWebDriverSession(resources, settings, evidence, logger) {
+    const toolSettings = {
+        snapshotFilter: settings.snapshotFilter,
+        snapshotTopPercent: settings.snapshotTopPercent,
+    };
+    const runtime = new BrowserToolRuntime(resources.page, toolSettings, logger);
+    let stagedSnapshot = null;
+    let closed = false;
+    const tools = createBrowserTools(runtime).map((tool) => ({
+        definition: { ...tool.definition, parameters: structuredClone(tool.definition.parameters) },
+        execute: async (args, context) => {
+            const result = await tool.execute(args, {
+                step: context.step,
+                turn: context.turn,
+                signal: context.signal,
+            });
+            return adaptToolResult(result, (snapshot) => {
+                stagedSnapshot = snapshot;
+            });
+        },
+    }));
+    return {
+        tools,
+        instructions: WEB_INSTRUCTIONS,
+        buildInitialContext: async ({ step, signal }) => {
+            signal.throwIfAborted();
+            const snapshot = await snapshotFor(runtime, toolSettings, step, logger);
+            if (snapshot && evidence) {
+                await evidence.capture({
+                    kind: 'aria-snapshot',
+                    mediaType: 'application/yaml',
+                    content: snapshot,
+                    stepId: step.id,
+                });
+            }
+            return snapshot ? [snapshotMessage(snapshot)] : [];
+        },
+        handleToolResponses: async ({ step, signal }) => {
+            signal.throwIfAborted();
+            const messages = [];
+            if (stagedSnapshot) {
+                if (evidence) {
+                    await evidence.capture({
+                        kind: 'aria-snapshot',
+                        mediaType: 'application/yaml',
+                        content: stagedSnapshot,
+                        stepId: step.id,
+                    });
+                }
+                messages.push(snapshotMessage(stagedSnapshot));
+                stagedSnapshot = null;
+            }
+            if (settings.screenshotsInModelContext) {
+                const screenshot = await new BrowserScreenshotService(await runtime.ensureActivePage()).getCompressedScreenshot();
+                messages.push({
+                    content: [
+                        { type: 'text', text: 'this is a current screenshot of the page' },
+                        { type: 'image', mediaType: screenshot.mimeType ?? 'image/png', data: screenshot.data },
+                    ],
+                    ephemeral: true,
+                });
+            }
+            return messages;
+        },
+        close: async () => {
+            if (closed)
+                return;
+            closed = true;
+            const failures = [];
+            try {
+                runtime.dispose();
+            }
+            catch (error) {
+                failures.push(error);
+            }
+            for (const close of [() => resources.context.close(), () => resources.browser.close()]) {
+                try {
+                    await close();
+                }
+                catch (error) {
+                    failures.push(error);
+                }
+            }
+            if (failures.length > 0)
+                throw new AggregateError(failures, 'Web driver cleanup failed');
+        },
+    };
+}
+export function webTarget(input) {
+    if (!input || typeof input !== 'object' || typeof input.baseUrl !== 'string') {
+        throw new Error('Web driver target requires baseUrl');
+    }
+    return { baseUrl: input.baseUrl };
+}
+export function webSettings(input) {
+    const value = input && typeof input === 'object' ? input : {};
+    return {
+        headless: value.headless ?? true,
+        snapshotFilter: value.snapshotFilter ?? false,
+        snapshotTopPercent: value.snapshotTopPercent ?? 10,
+        screenshotsInModelContext: value.screenshotsInModelContext ?? false,
+    };
+}
+export async function rollbackWebResources(resources) {
+    await Promise.allSettled([resources.context?.close(), resources.browser?.close()]);
+}
+function adaptToolResult(result, stage) {
+    if (!result || typeof result === 'string')
+        return result;
+    if (result.snapshot)
+        stage(result.snapshot);
+    return { response: result.response, status: result.status ?? 'success' };
+}
+async function snapshotFor(runtime, settings, step, logger) {
+    return new SnapshotService(await runtime.ensureActivePage(), settings, logger, step).get();
+}
+function snapshotMessage(snapshot) {
+    return { content: `this is a current page snapshot:\n${snapshot}`, ephemeral: true };
+}
+//# sourceMappingURL=session.js.map

package/dist/drivers/web/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/drivers/web/session.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAA;AACxE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAkB7D,MAAM,gBAAgB,GAAG;IACxB,8HAA8H;IAC9H,8HAA8H;IAC9H,4GAA4G;IAC5G,+OAA+O;IAC/O,gTAAgT;CAChT,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC3C,SAAuB,EACvB,QAA2B,EAC3B,QAAwC,EACxC,MAAoB;IAEpB,MAAM,YAAY,GAAG;QACpB,cAAc,EAAE,QAAQ,CAAC,cAAc;QACvC,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB;KAC/C,CAAA;IACD,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC,SAAS,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,CAAA;IAC5E,IAAI,cAAc,GAAkB,IAAI,CAAA;IACxC,IAAI,MAAM,GAAG,KAAK,CAAA;IAClB,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC,GAAG,CAAa,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpE,UAAU,EAAE,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;QAC3F,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;YAChC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;gBACvC,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,MAAM,EAAE,OAAO,CAAC,MAAM;aACtB,CAAC,CAAA;YACF,OAAO,eAAe,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;gBAC3C,cAAc,GAAG,QAAQ,CAAA;YAC1B,CAAC,CAAC,CAAA;QACH,CAAC;KACD,CAAC,CAAC,CAAA;IAEH,OAAO;QACN,KAAK;QACL,YAAY,EAAE,gBAAgB;QAC9B,mBAAmB,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE;YAC/C,MAAM,CAAC,cAAc,EAAE,CAAA;YACvB,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;YACvE,IAAI,QAAQ,IAAI,QAAQ,EAAE,CAAC;gBAC1B,MAAM,QAAQ,CAAC,OAAO,CAAC;oBACtB,IAAI,EAAE,eAAe;oBACrB,SAAS,EAAE,kBAAkB;oBAC7B,OAAO,EAAE,QAAQ;oBACjB,MAAM,EAAE,IAAI,CAAC,EAAE;iBACf,CAAC,CAAA;YACH,CAAC;YACD,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QACnD,CAAC;QACD,mBAAmB,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE;YAC/C,MAAM,CAAC,cAAc,EAAE,CAAA;YACvB,MAAM,QAAQ,GAA2B,EAAE,CAAA;YAC3C,IAAI,cAAc,EAAE,CAAC;gBACpB,IAAI,QAAQ,EAAE,CAAC;oBACd,MAAM,QAAQ,CAAC,OAAO,CAAC;wBACtB,IAAI,EAAE,eAAe;wBACrB,SAAS,EAAE,kBAAkB;wBAC7B,OAAO,EAAE,cAAc;wBACvB,MAAM,EAAE,IAAI,CAAC,EAAE;qBACf,CAAC,CAAA;gBACH,CAAC;gBACD,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC,CAAA;gBAC9C,cAAc,GAAG,IAAI,CAAA;YACtB,CAAC;YACD,IAAI,QAAQ,CAAC,yBAAyB,EAAE,CAAC;gBACxC,MAAM,UAAU,GAAG,MAAM,IAAI,wBAAwB,CACpD,MAAM,OAAO,CAAC,gBAAgB,EAAE,CAChC,CAAC,uBAAuB,EAAE,CAAA;gBAC3B,QAAQ,CAAC,IAAI,CAAC;oBACb,OAAO,EAAE;wBACR,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,0CAA0C,EAAE;wBAClE,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,QAAQ,IAAI,WAAW,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE;qBACvF;oBACD,SAAS,EAAE,IAAI;iBACf,CAAC,CAAA;YACH,CAAC;YACD,OAAO,QAAQ,CAAA;QAChB,CAAC;QACD,KAAK,EAAE,KAAK,IAAI,EAAE;YACjB,IAAI,MAAM;gBAAE,OAAM;YAClB,MAAM,GAAG,IAAI,CAAA;YACb,MAAM,QAAQ,GAAc,EAAE,CAAA;YAC9B,IAAI,CAAC;gBACJ,OAAO,CAAC,OAAO,EAAE,CAAA;YAClB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACrB,CAAC;YACD,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC;gBACxF,IAAI,CAAC;oBACJ,MAAM,KAAK,EAAE,CAAA;gBACd,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBAChB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;gBACrB,CAAC;YACF,CAAC;YACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAM,IAAI,cAAc,CAAC,QAAQ,EAAE,2BAA2B,CAAC,CAAA;QACzF,CAAC;KACD,CAAA;AACF,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAc;IACvC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAQ,KAA+B,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzG,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;IACtD,CAAC;IACD,OAAO,EAAE,OAAO,EAAG,KAA6B,CAAC,OAAO,EAAE,CAAA;AAC3D,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACzC,MAAM,KAAK,GAAG,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAE,KAAoC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC7F,OAAO;QACN,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;QAChC,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,KAAK;QAC7C,kBAAkB,EAAE,KAAK,CAAC,kBAAkB,IAAI,EAAE;QAClD,yBAAyB,EAAE,KAAK,CAAC,yBAAyB,IAAI,KAAK;KACnE,CAAA;AACF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,SAAgC;IAC1E,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;AACnF,CAAC;AAED,SAAS,eAAe,CAAC,MAAuB,EAAE,KAAiC;IAClF,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAA;IACxD,IAAI,MAAM,CAAC,QAAQ;QAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,SAAS,EAAE,CAAA;AACzE,CAAC;AAED,KAAK,UAAU,WAAW,CACzB,OAA2B,EAC3B,QAA0E,EAC1E,IAAgB,EAChB,MAAoB;IAEpB,OAAO,IAAI,eAAe,CAAC,MAAM,OAAO,CAAC,gBAAgB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE,CAAA;AAC3F,CAAC;AAED,SAAS,eAAe,CAAC,QAAgB;IACxC,OAAO,EAAE,OAAO,EAAE,qCAAqC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAA;AACrF,CAAC"}

package/dist/drivers/web/tools/network-request-recorder.d.ts

@@ -0,0 +1,46 @@
+import type { BrowserContext } from 'playwright';
+type Clock = () => number;
+export type NetworkRequestStatus = number | 'PENDING' | 'FAILED';
+export type RecordedNetworkRequest = {
+    sequence: number;
+    method: string;
+    url: string;
+    resourceType: string;
+    status: NetworkRequestStatus;
+    statusText: string;
+    startedAt: number;
+    completedAt: number | null;
+};
+export type NetworkRequestListOptions = {
+    includeStatic?: boolean;
+};
+export type NetworkRequestBodyPart = 'request' | 'response';
+export declare class NetworkRequestRecorder {
+    private readonly context;
+    private readonly clock;
+    static readonly MAX_RECORDS = 200;
+    static readonly API_RESOURCE_TYPES: string[];
+    static readonly MAX_BODY_CHARS = 2000;
+    private readonly records;
+    private readonly recordsByRequest;
+    private nextSequence;
+    private startTime;
+    constructor(context: BrowserContext, clock?: Clock);
+    attach(): void;
+    detach(): void;
+    reset(): void;
+    list(options?: NetworkRequestListOptions): RecordedNetworkRequest[];
+    format(options?: NetworkRequestListOptions): string;
+    detail(sequence: number): Promise<string>;
+    body(sequence: number, part: NetworkRequestBodyPart): Promise<string>;
+    private requestBody;
+    private responseBody;
+    private findRecord;
+    private handleRequest;
+    private handleResponse;
+    private handleRequestFailed;
+    private dropOldestRecordsOverLimit;
+    private elapsed;
+}
+export {};
+//# sourceMappingURL=network-request-recorder.d.ts.map

package/dist/drivers/web/tools/network-request-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-request-recorder.d.ts","sourceRoot":"","sources":["../../../../src/drivers/web/tools/network-request-recorder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAqB,MAAM,YAAY,CAAA;AAEnE,KAAK,KAAK,GAAG,MAAM,MAAM,CAAA;AAEzB,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAA;AAEhE,MAAM,MAAM,sBAAsB,GAAG;IACpC,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,oBAAoB,CAAA;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG;IACvC,aAAa,CAAC,EAAE,OAAO,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,UAAU,CAAA;AAY3D,qBAAa,sBAAsB;IAWjC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAXvB,MAAM,CAAC,QAAQ,CAAC,WAAW,OAAM;IACjC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,WAAmB;IACrD,MAAM,CAAC,QAAQ,CAAC,cAAc,QAAiB;IAE/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAoC;IACrE,OAAO,CAAC,YAAY,CAAI;IACxB,OAAO,CAAC,SAAS,CAAQ;gBAGP,OAAO,EAAE,cAAc,EACvB,KAAK,GAAE,KAAwB;IAKjD,MAAM,IAAI,IAAI;IAMd,MAAM,IAAI,IAAI;IAMd,KAAK,IAAI,IAAI;IAOb,IAAI,CAAC,OAAO,GAAE,yBAA8B,GAAG,sBAAsB,EAAE;IAUvE,MAAM,CAAC,OAAO,GAAE,yBAA8B,GAAG,MAAM;IASjD,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBzC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC;IAa3E,OAAO,CAAC,WAAW;YASL,YAAY;IAW1B,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,aAAa,CAgBpB;IAED,OAAO,CAAC,cAAc,CASrB;IAED,OAAO,CAAC,mBAAmB,CAS1B;IAED,OAAO,CAAC,0BAA0B;IAWlC,OAAO,CAAC,OAAO;CAGf"}

package/dist/drivers/web/tools/network-request-recorder.js

@@ -0,0 +1,164 @@
+const NETWORK_HEADER = 'Network requests since the last browser action (call again after the next action; numbers shown here become stale once you do):';
+const MAX_BODY_CHARS = 2000;
+export class NetworkRequestRecorder {
+    context;
+    clock;
+    static MAX_RECORDS = 200;
+    static API_RESOURCE_TYPES = ['fetch', 'xhr'];
+    static MAX_BODY_CHARS = MAX_BODY_CHARS;
+    records = [];
+    recordsByRequest = new Map();
+    nextSequence = 1;
+    startTime;
+    constructor(context, clock = () => Date.now()) {
+        this.context = context;
+        this.clock = clock;
+        this.startTime = this.clock();
+    }
+    attach() {
+        this.context.on('request', this.handleRequest);
+        this.context.on('response', this.handleResponse);
+        this.context.on('requestfailed', this.handleRequestFailed);
+    }
+    detach() {
+        this.context.off('request', this.handleRequest);
+        this.context.off('response', this.handleResponse);
+        this.context.off('requestfailed', this.handleRequestFailed);
+    }
+    reset() {
+        this.records.length = 0;
+        this.recordsByRequest.clear();
+        this.nextSequence = 1;
+        this.startTime = this.clock();
+    }
+    list(options = {}) {
+        const records = options.includeStatic
+            ? this.records
+            : this.records.filter((record) => NetworkRequestRecorder.API_RESOURCE_TYPES.includes(record.summary.resourceType));
+        return records.map((record) => record.summary);
+    }
+    format(options = {}) {
+        const summaries = this.list(options);
+        if (summaries.length === 0) {
+            return '';
+        }
+        return [NETWORK_HEADER, ...summaries.map((summary) => formatRecord(summary))].join('\n');
+    }
+    async detail(sequence) {
+        const record = this.findRecord(sequence);
+        if (!record) {
+            return unknownSequenceMessage(sequence);
+        }
+        const response = await record.request.response().catch(() => null);
+        const lines = [
+            formatRecord(record.summary),
+            `resourceType: ${record.summary.resourceType}`,
+            `request headers: ${formatHeaders(record.request.headers())}`,
+            `response headers: ${response ? formatHeaders(response.headers()) : 'not available yet'}`,
+        ];
+        return lines.join('\n');
+    }
+    async body(sequence, part) {
+        const record = this.findRecord(sequence);
+        if (!record) {
+            return unknownSequenceMessage(sequence);
+        }
+        if (part === 'request') {
+            return this.requestBody(sequence, record);
+        }
+        return this.responseBody(sequence, record);
+    }
+    requestBody(sequence, record) {
+        const postData = record.request.postData();
+        if (postData === null) {
+            return `${sequence}. [${record.summary.method}] ${record.summary.url} has no request body.`;
+        }
+        return `${sequence}. [${record.summary.method}] ${record.summary.url} request body:\n${truncateBody(postData)}`;
+    }
+    async responseBody(sequence, record) {
+        const response = await record.request.response().catch(() => null);
+        if (!response) {
+            return `${sequence}. [${record.summary.method}] ${record.summary.url} has no response body yet.`;
+        }
+        const text = await response.text().catch((error) => `<failed to read response body: ${error}>`);
+        const contentType = (response.headers()['content-type'] ?? 'unknown').split(';')[0].trim();
+        return `${sequence}. [${record.summary.method}] ${record.summary.url} response body (${contentType}):\n${truncateBody(text)}`;
+    }
+    findRecord(sequence) {
+        return this.records.find((record) => record.summary.sequence === sequence);
+    }
+    handleRequest = (request) => {
+        const summary = {
+            sequence: this.nextSequence++,
+            method: request.method(),
+            url: request.url(),
+            resourceType: request.resourceType(),
+            status: 'PENDING',
+            statusText: '',
+            startedAt: this.elapsed(),
+            completedAt: null,
+        };
+        const record = { summary, request };
+        this.records.push(record);
+        this.recordsByRequest.set(request, record);
+        this.dropOldestRecordsOverLimit();
+    };
+    handleResponse = (response) => {
+        const record = this.recordsByRequest.get(response.request());
+        if (!record) {
+            return;
+        }
+        record.summary.status = response.status();
+        record.summary.statusText = response.statusText();
+        record.summary.completedAt = this.elapsed();
+    };
+    handleRequestFailed = (request) => {
+        const record = this.recordsByRequest.get(request);
+        if (!record || record.summary.status !== 'PENDING') {
+            return;
+        }
+        record.summary.status = 'FAILED';
+        record.summary.statusText = request.failure()?.errorText ?? 'request failed';
+        record.summary.completedAt = this.elapsed();
+    };
+    dropOldestRecordsOverLimit() {
+        while (this.records.length > NetworkRequestRecorder.MAX_RECORDS) {
+            const dropped = this.records.shift();
+            if (!dropped) {
+                return;
+            }
+            this.recordsByRequest.delete(dropped.request);
+        }
+    }
+    elapsed() {
+        return this.clock() - this.startTime;
+    }
+}
+function formatRecord(record) {
+    const prefix = `${record.sequence}. [${record.method}] ${record.url} =>`;
+    if (record.status === 'PENDING') {
+        return `${prefix} [PENDING]`;
+    }
+    if (record.status === 'FAILED') {
+        return `${prefix} [FAILED] ${record.statusText}`;
+    }
+    const duration = record.completedAt === null ? '' : ` (${record.completedAt - record.startedAt}ms)`;
+    return `${prefix} [${record.status}]${record.statusText ? ` ${record.statusText}` : ''}${duration}`;
+}
+function formatHeaders(headers) {
+    const entries = Object.entries(headers);
+    if (entries.length === 0) {
+        return 'none';
+    }
+    return entries.map(([key, value]) => `${key}: ${value}`).join(', ');
+}
+function unknownSequenceMessage(sequence) {
+    return `Network request '${sequence}' was not found. It may have been evicted from the buffer or cleared by a newer browser action. Call 'browser_network_requests' again to see the current list.`;
+}
+function truncateBody(text) {
+    if (text.length <= MAX_BODY_CHARS) {
+        return text;
+    }
+    return `${text.slice(0, MAX_BODY_CHARS)}... (truncated, ${text.length} chars total)`;
+}
+//# sourceMappingURL=network-request-recorder.js.map

package/dist/drivers/web/tools/network-request-recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-request-recorder.js","sourceRoot":"","sources":["../../../../src/drivers/web/tools/network-request-recorder.ts"],"names":[],"mappings":"AA4BA,MAAM,cAAc,GACnB,iIAAiI,CAAA;AAElI,MAAM,cAAc,GAAG,IAAI,CAAA;AAE3B,MAAM,OAAO,sBAAsB;IAWhB;IACA;IAXlB,MAAM,CAAU,WAAW,GAAG,GAAG,CAAA;IACjC,MAAM,CAAU,kBAAkB,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IACrD,MAAM,CAAU,cAAc,GAAG,cAAc,CAAA;IAE9B,OAAO,GAAoB,EAAE,CAAA;IAC7B,gBAAgB,GAAG,IAAI,GAAG,EAA0B,CAAA;IAC7D,YAAY,GAAG,CAAC,CAAA;IAChB,SAAS,CAAQ;IAEzB,YACkB,OAAuB,EACvB,QAAe,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;QAD/B,YAAO,GAAP,OAAO,CAAgB;QACvB,UAAK,GAAL,KAAK,CAA0B;QAEhD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,CAAA;IAC9B,CAAC;IAED,MAAM;QACL,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,CAAA;QAC9C,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,IAAI,CAAC,cAAc,CAAC,CAAA;QAChD,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,eAAe,EAAE,IAAI,CAAC,mBAAmB,CAAC,CAAA;IAC3D,CAAC;IAED,MAAM;QACL,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,CAAA;QAC/C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,cAAc,CAAC,CAAA;QACjD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,CAAC,mBAAmB,CAAC,CAAA;IAC5D,CAAC;IAED,KAAK;QACJ,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAA;QACvB,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAA;QAC7B,IAAI,CAAC,YAAY,GAAG,CAAC,CAAA;QACrB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,CAAA;IAC9B,CAAC;IAED,IAAI,CAAC,UAAqC,EAAE;QAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa;YACpC,CAAC,CAAC,IAAI,CAAC,OAAO;YACd,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAC/B,sBAAsB,CAAC,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAC/E,CAAA;QAEH,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAC/C,CAAC;IAED,MAAM,CAAC,UAAqC,EAAE;QAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACpC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,EAAE,CAAA;QACV,CAAC;QAED,OAAO,CAAC,cAAc,EAAE,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzF,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAAgB;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAA;QACxC,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,OAAO,sBAAsB,CAAC,QAAQ,CAAC,CAAA;QACxC,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAS,EAAE,CAAC,IAAI,CAAC,CAAA;QACxE,MAAM,KAAK,GAAG;YACb,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC;YAC5B,iBAAiB,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE;YAC9C,oBAAoB,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,EAAE;YAC7D,qBAAqB,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,mBAAmB,EAAE;SACzF,CAAA;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACxB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAgB,EAAE,IAA4B;QACxD,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAA;QACxC,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,OAAO,sBAAsB,CAAC,QAAQ,CAAC,CAAA;QACxC,CAAC;QAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QAC1C,CAAC;QAED,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IAC3C,CAAC;IAEO,WAAW,CAAC,QAAgB,EAAE,MAAqB;QAC1D,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAA;QAC1C,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACvB,OAAO,GAAG,QAAQ,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,OAAO,CAAC,GAAG,uBAAuB,CAAA;QAC5F,CAAC;QAED,OAAO,GAAG,QAAQ,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,OAAO,CAAC,GAAG,mBAAmB,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAA;IAChH,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,QAAgB,EAAE,MAAqB;QACjE,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAS,EAAE,CAAC,IAAI,CAAC,CAAA;QACxE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,OAAO,GAAG,QAAQ,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,OAAO,CAAC,GAAG,4BAA4B,CAAA;QACjG,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,kCAAkC,KAAK,GAAG,CAAC,CAAA;QACxG,MAAM,WAAW,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,cAAc,CAAC,IAAI,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QAC1F,OAAO,GAAG,QAAQ,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,OAAO,CAAC,GAAG,mBAAmB,WAAW,OAAO,YAAY,CAAC,IAAI,CAAC,EAAE,CAAA;IAC9H,CAAC;IAEO,UAAU,CAAC,QAAgB;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAA;IAC3E,CAAC;IAEO,aAAa,GAAG,CAAC,OAAgB,EAAQ,EAAE;QAClD,MAAM,OAAO,GAA2B;YACvC,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE;YAC7B,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;YACxB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;YAClB,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE;YACpC,MAAM,EAAE,SAAS;YACjB,UAAU,EAAE,EAAE;YACd,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE;YACzB,WAAW,EAAE,IAAI;SACjB,CAAA;QAED,MAAM,MAAM,GAAkB,EAAE,OAAO,EAAE,OAAO,EAAE,CAAA;QAClD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACzB,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QAC1C,IAAI,CAAC,0BAA0B,EAAE,CAAA;IAClC,CAAC,CAAA;IAEO,cAAc,GAAG,CAAC,QAAkB,EAAQ,EAAE;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;QAC5D,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,OAAM;QACP,CAAC;QAED,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAA;QACzC,MAAM,CAAC,OAAO,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAA;QACjD,MAAM,CAAC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,CAAA;IAC5C,CAAC,CAAA;IAEO,mBAAmB,GAAG,CAAC,OAAgB,EAAQ,EAAE;QACxD,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACjD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACpD,OAAM;QACP,CAAC;QAED,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAA;QAChC,MAAM,CAAC,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,SAAS,IAAI,gBAAgB,CAAA;QAC5E,MAAM,CAAC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,CAAA;IAC5C,CAAC,CAAA;IAEO,0BAA0B;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,sBAAsB,CAAC,WAAW,EAAE,CAAC;YACjE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;YACpC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACd,OAAM;YACP,CAAC;YAED,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAC9C,CAAC;IACF,CAAC;IAEO,OAAO;QACd,OAAO,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,SAAS,CAAA;IACrC,CAAC;;AAGF,SAAS,YAAY,CAAC,MAA8B;IACnD,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,MAAM,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,GAAG,KAAK,CAAA;IAExE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,GAAG,MAAM,YAAY,CAAA;IAC7B,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,GAAG,MAAM,aAAa,MAAM,CAAC,UAAU,EAAE,CAAA;IACjD,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,SAAS,KAAK,CAAA;IACnG,OAAO,GAAG,MAAM,KAAK,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAA;AACpG,CAAC;AAED,SAAS,aAAa,CAAC,OAA+B;IACrD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IACvC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAA;IACd,CAAC;IAED,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACpE,CAAC;AAED,SAAS,sBAAsB,CAAC,QAAgB;IAC/C,OAAO,oBAAoB,QAAQ,gKAAgK,CAAA;AACpM,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IACjC,IAAI,IAAI,CAAC,MAAM,IAAI,cAAc,EAAE,CAAC;QACnC,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,mBAAmB,IAAI,CAAC,MAAM,eAAe,CAAA;AACrF,CAAC"}

package/dist/{tools/browser → drivers/web/tools}/screenshot-service.d.ts

@@ -1,4 +1,4 @@
-import { Page } from '@playwright/test';
+import type { Page } from 'playwright';
 export declare class BrowserScreenshotService {
     private readonly page;
     constructor(page: Page);

package/dist/drivers/web/tools/screenshot-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot-service.d.ts","sourceRoot":"","sources":["../../../../src/drivers/web/tools/screenshot-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAGtC,qBAAa,wBAAwB;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,IAAI;IAEjC,uBAAuB,IAAI,OAAO,CAAC;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAe7E"}

package/dist/drivers/web/tools/screenshot-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot-service.js","sourceRoot":"","sources":["../../../../src/drivers/web/tools/screenshot-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,MAAM,OAAO,wBAAwB;IACP;IAA7B,YAA6B,IAAU;QAAV,SAAI,GAAJ,IAAI,CAAM;IAAG,CAAC;IAE3C,KAAK,CAAC,uBAAuB;QAC5B,IAAI,CAAC;YACJ,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAA;YAC/C,MAAM,gBAAgB,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC;iBAC9C,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;iBAClD,QAAQ,EAAE,CAAA;YACZ,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;YACjD,CAAC;YAED,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAA;QAC5E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,yCAAyC,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;QACpF,CAAC;IACF,CAAC;CACD"}

package/dist/drivers/web/tools/snapshot-filter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/drivers/web/tools/snapshot-filter/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EACN,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,SAAS,GACd,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/drivers/web/tools/snapshot-filter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/drivers/web/tools/snapshot-filter/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EACN,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,GAKhB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/drivers/web/tools/snapshot-filter/semantic-scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-scorer.d.ts","sourceRoot":"","sources":["../../../../../src/drivers/web/tools/snapshot-filter/semantic-scorer.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,UAAU,GAAG,SAAS,CAAA;AACjF,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAA;AACrD,MAAM,MAAM,SAAS,GAAG,SAAS,EAAE,CAAA;AAEnC,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;IACzB,OAAO,EAAE,SAAS,CAAA;IAClB,GAAG,EAAE,MAAM,CAAA;CACX;AAoBD,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAoCpG;AAgED,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,aAAa,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,EAAE,CAErG;AAED,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,aAAa,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,aAAa,EAAE,CAQrG"}

package/dist/drivers/web/tools/snapshot-filter/semantic-scorer.js.map

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

package/dist/drivers/web/tools/snapshot-filter/snapshot-filter.d.ts

@@ -0,0 +1,5 @@
+import type { RuntimeLogger } from '../../../../logging/types.js';
+import type { BrowserStepIntent } from '../types.js';
+import { JsonValue } from './semantic-scorer.js';
+export declare function filterSnapshot(json: JsonValue, runtimeLogger: RuntimeLogger, step?: BrowserStepIntent, defaultTopPercent?: number): Promise<JsonValue>;
+//# sourceMappingURL=snapshot-filter.d.ts.map

package/dist/drivers/web/tools/snapshot-filter/snapshot-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-filter.d.ts","sourceRoot":"","sources":["../../../../../src/drivers/web/tools/snapshot-filter/snapshot-filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAuC,SAAS,EAAyB,MAAM,sBAAsB,CAAA;AAM5G,wBAAsB,cAAc,CACnC,IAAI,EAAE,SAAS,EACf,aAAa,EAAE,aAAa,EAC5B,IAAI,CAAC,EAAE,iBAAiB,EACxB,iBAAiB,GAAE,MAA4B,GAC7C,OAAO,CAAC,SAAS,CAAC,CA6CpB"}

package/dist/drivers/web/tools/snapshot-filter/snapshot-filter.js

@@ -0,0 +1,56 @@
+import { filterByThreshold, filterTopPercent, scoreSnapshotElements } from './semantic-scorer.js';
+import { reconstructTree } from './tree-reconstructor.js';
+const DEFAULT_SCORE_THRESHOLD = 0.3;
+const DEFAULT_TOP_PERCENT = 10;
+export async function filterSnapshot(json, runtimeLogger, step, defaultTopPercent = DEFAULT_TOP_PERCENT) {
+    if (!step) {
+        runtimeLogger.debug('filterSnapshot: No step provided, returning original snapshot');
+        return json;
+    }
+    const searchQuery = resolveSearchQuery(step, runtimeLogger);
+    runtimeLogger.debug(`filterSnapshot: Resolved search query: ${JSON.stringify(searchQuery)}`);
+    if (!searchQuery) {
+        runtimeLogger.debug('filterSnapshot: No search query found, returning original snapshot');
+        return json;
+    }
+    const scoredElements = await scoreSnapshotElements(json, searchQuery);
+    runtimeLogger.debug(`filterSnapshot: Scored ${scoredElements.length} elements`);
+    if (scoredElements.length === 0) {
+        runtimeLogger.debug('filterSnapshot: No scored elements, returning original snapshot');
+        return json;
+    }
+    const topPercent = resolveTopPercent(step, defaultTopPercent);
+    const selectedByPrimaryRule = filterTopPercent(scoredElements, topPercent / 100);
+    runtimeLogger.debug(`filterSnapshot: Filtered to ${selectedByPrimaryRule.length} elements from top ${topPercent}%`);
+    const selectedElements = selectedByPrimaryRule.length > 0
+        ? selectedByPrimaryRule
+        : filterByThreshold(scoredElements, DEFAULT_SCORE_THRESHOLD);
+    if (selectedElements !== selectedByPrimaryRule) {
+        runtimeLogger.debug(`filterSnapshot: Top-percent selection was empty, falling back to threshold ${DEFAULT_SCORE_THRESHOLD}`);
+    }
+    const filtered = reconstructTree(json, selectedElements);
+    const originalSize = JSON.stringify(json).length;
+    const filteredSize = JSON.stringify(filtered).length;
+    runtimeLogger.info(`filterSnapshot: Reduced snapshot from ${originalSize} to ${filteredSize} chars (${Math.round((1 - filteredSize / originalSize) * 100)}% reduction)`);
+    return filtered;
+}
+function resolveTopPercent(step, defaultTopPercent) {
+    const candidate = step.topPercent;
+    if (typeof candidate === 'number' && candidate > 0 && candidate <= 100) {
+        return candidate;
+    }
+    return defaultTopPercent;
+}
+function resolveSearchQuery(step, runtimeLogger) {
+    if (step.search && step.search.length > 0) {
+        runtimeLogger.info(`filterSnapshot: using search keywords: ${JSON.stringify(step.search)}`);
+        return step.search.join(' ');
+    }
+    const semanticQuery = `${step.action} ${step.expect}`.trim();
+    if (semanticQuery) {
+        runtimeLogger.info(`filterSnapshot: using step semantics`);
+        return semanticQuery;
+    }
+    return '';
+}
+//# sourceMappingURL=snapshot-filter.js.map

package/dist/drivers/web/tools/snapshot-filter/snapshot-filter.js.map

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

package/dist/drivers/web/tools/snapshot-filter/tree-reconstructor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-reconstructor.d.ts","sourceRoot":"","sources":["../../../../../src/drivers/web/tools/snapshot-filter/tree-reconstructor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,SAAS,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEtF,wBAAgB,eAAe,CAAC,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,aAAa,EAAE,GAAG,SAAS,CAOrG"}

package/dist/drivers/web/tools/snapshot-filter/tree-reconstructor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-reconstructor.js","sourceRoot":"","sources":["../../../../../src/drivers/web/tools/snapshot-filter/tree-reconstructor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,eAAe,CAAC,YAAuB,EAAE,gBAAiC;IACzF,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO,YAAY,CAAA;IACpB,CAAC;IAED,MAAM,QAAQ,GAAG,uBAAuB,CAAC,gBAAgB,CAAC,CAAA;IAC1D,OAAO,iBAAiB,CAAC,YAAY,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,YAAY,CAAA;AACrE,CAAC;AAED,SAAS,uBAAuB,CAAC,QAAyB;IACzD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAA;IAE/B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/C,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;QACpD,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;IACxC,CAAC;IAED,OAAO,KAAK,CAAA;AACb,CAAC;AAED,SAAS,iBAAiB,CACzB,KAAgB,EAChB,aAA0B,EAC1B,WAAgC;IAEhC,IAAI,CAAC,wBAAwB,CAAC,WAAW,EAAE,aAAa,CAAC,EAAE,CAAC;QAC3D,OAAO,SAAS,CAAA;IACjB,CAAC;IAED,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACjD,OAAO,KAAK,CAAA;IACb,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,kBAAkB,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,CAAC,CAAA;IAC7D,CAAC;IAED,OAAO,mBAAmB,CAAC,KAAmB,EAAE,aAAa,EAAE,WAAW,CAAC,CAAA;AAC5E,CAAC;AAED,SAAS,wBAAwB,CAAC,IAAyB,EAAE,aAA0B;IACtF,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;IACpC,IAAI,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAwB,CAAA;QAC9D,IAAI,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;YAChC,OAAO,IAAI,CAAA;QACZ,CAAC;IACF,CAAC;IAED,OAAO,KAAK,CAAA;AACb,CAAC;AAED,SAAS,YAAY,CAAC,iBAAsC,EAAE,UAA+B;IAC5F,OAAO,CACN,iBAAiB,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM;QAC5C,iBAAiB,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,UAAU,CAAC,KAAK,CAAC,CAAC,CAC1E,CAAA;AACF,CAAC;AAED,SAAS,kBAAkB,CAC1B,KAAgB,EAChB,aAA0B,EAC1B,WAAgC;IAEhC,MAAM,aAAa,GAAgB,EAAE,CAAA;IAErC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACnD,MAAM,aAAa,GAAG,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC,GAAG,WAAW,EAAE,KAAK,CAAC,CAAC,CAAA;QAC7F,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YACjC,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;QAClC,CAAC;IACF,CAAC;IAED,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,qBAAqB,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;IAC7E,CAAC;IAED,OAAO,aAAa,CAAA;AACrB,CAAC;AAED,SAAS,mBAAmB,CAC3B,KAAiB,EACjB,aAA0B,EAC1B,WAAgC;IAEhC,MAAM,cAAc,GAAe,EAAE,CAAA;IACrC,IAAI,UAAU,GAAG,KAAK,CAAA;IAEtB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACtC,MAAM,aAAa,GAAG,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,aAAa,EAAE,CAAC,GAAG,WAAW,EAAE,GAAG,CAAC,CAAC,CAAA;QACzF,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YACjC,cAAc,CAAC,GAAG,CAAC,GAAG,aAAa,CAAA;YACnC,UAAU,GAAG,IAAI,CAAA;QAClB,CAAC;IACF,CAAC;IAED,IAAI,CAAC,UAAU,IAAI,qBAAqB,CAAC,aAAa,EAAE,WAAW,CAAC,EAAE,CAAC;QACtE,OAAO,KAAK,CAAA;IACb,CAAC;IAED,OAAO,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAA;AAC/C,CAAC;AAED,SAAS,qBAAqB,CAAC,aAA0B,EAAE,WAAgC;IAC1F,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;IAElD,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAwB,CAAA;QAC9D,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC,MAAM,IAAI,cAAc,KAAK,YAAY,EAAE,CAAC;YAC7E,OAAO,IAAI,CAAA;QACZ,CAAC;IACF,CAAC;IAED,OAAO,KAAK,CAAA;AACb,CAAC"}

package/dist/drivers/web/tools/snapshot-service.d.ts

@@ -0,0 +1,31 @@
+import type { Page } from 'playwright';
+import type { RuntimeLogger } from '../../../logging/types.js';
+import type { BrowserStepIntent, WebToolSettings } from './types.js';
+export type BrowserSnapshot = string | null;
+export interface SnapshotServiceOptions {
+    skipFilter?: boolean;
+}
+export declare class SnapshotService {
+    private readonly page;
+    private readonly config;
+    private readonly runtimeLogger;
+    private readonly step?;
+    private readonly options;
+    constructor(page: Page | null, config: WebToolSettings, runtimeLogger: RuntimeLogger, step?: BrowserStepIntent, options?: SnapshotServiceOptions);
+    /**
+     * Waits for two consecutive reads of the page's HTML to match before a snapshot is captured.
+     *
+     * This is an ordinary wait, not a Playwright assertion: `expect.poll` would record every
+     * rejected attempt as its own failed child step, so a page that settles on its second read
+     * would render as a green step containing a red ✗ that had nothing to do with the step's
+     * actual outcome. An ordinary wait — the same thing `page.waitForLoadState` already does for
+     * navigation — reports only a plain error if the page genuinely never settles.
+     */
+    private waitForStableHtml;
+    private getHeader;
+    private minify;
+    private redactAds;
+    private compress;
+    get(): Promise<BrowserSnapshot>;
+}
+//# sourceMappingURL=snapshot-service.d.ts.map

package/dist/drivers/web/tools/snapshot-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-service.d.ts","sourceRoot":"","sources":["../../../../src/drivers/web/tools/snapshot-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAEtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAE9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEpE,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,IAAI,CAAA;AAE3C,MAAM,WAAW,sBAAsB;IACtC,UAAU,CAAC,EAAE,OAAO,CAAA;CACpB;AAKD,qBAAa,eAAe;IAE1B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAJP,IAAI,EAAE,IAAI,GAAG,IAAI,EACjB,MAAM,EAAE,eAAe,EACvB,aAAa,EAAE,aAAa,EAC5B,IAAI,CAAC,EAAE,iBAAiB,EACxB,OAAO,GAAE,sBAA2B;IAGtD;;;;;;;;OAQG;YACW,iBAAiB;YAgBjB,SAAS;IAQvB,OAAO,CAAC,MAAM;IASd,OAAO,CAAC,SAAS;YAkBH,QAAQ;IAUhB,GAAG,IAAI,OAAO,CAAC,eAAe,CAAC;CAerC"}

package/dist/{tools/browser → drivers/web/tools}/snapshot-service.js

@@ -1,17 +1,43 @@
 import { parse } from 'yaml';
-import { RuntimeConfig } from '../../config/runtime-config.js';
-import { logger } from '../../logging/index.js';
 import { filterSnapshot } from './snapshot-filter/index.js';
+const STABILITY_POLL_INTERVAL_MS = 500;
+const STABILITY_TIMEOUT_MS = 30_000;
 export class SnapshotService {
     page;
+    config;
+    runtimeLogger;
     step;
     options;
-    runtimeConfig = new RuntimeConfig();
-    constructor(page, step, options = {}) {
+    constructor(page, config, runtimeLogger, step, options = {}) {
         this.page = page;
+        this.config = config;
+        this.runtimeLogger = runtimeLogger;
         this.step = step;
         this.options = options;
     }
+    /**
+     * Waits for two consecutive reads of the page's HTML to match before a snapshot is captured.
+     *
+     * This is an ordinary wait, not a Playwright assertion: `expect.poll` would record every
+     * rejected attempt as its own failed child step, so a page that settles on its second read
+     * would render as a green step containing a red ✗ that had nothing to do with the step's
+     * actual outcome. An ordinary wait — the same thing `page.waitForLoadState` already does for
+     * navigation — reports only a plain error if the page genuinely never settles.
+     */
+    async waitForStableHtml(page) {
+        const deadline = Date.now() + STABILITY_TIMEOUT_MS;
+        for (;;) {
+            const before = await page.locator('html').innerHTML();
+            await page.waitForTimeout(STABILITY_POLL_INTERVAL_MS);
+            const after = await page.locator('html').innerHTML();
+            if (before === after) {
+                return;
+            }
+            if (Date.now() >= deadline) {
+                throw new Error(`page snapshot did not stabilize within ${STABILITY_TIMEOUT_MS}ms`);
+            }
+        }
+    }
     async getHeader() {
         if (!this.page) {
             throw new Error('Page is not initialized');
@@ -44,8 +70,10 @@ export class SnapshotService {
     }
     async compress(snapshot) {
         const snapshotTree = parse(snapshot)?.[0] ?? { state: 'page is blank - navigate to a relevant page url' };
-        const shouldSkipFilter = this.options.skipFilter || !this.runtimeConfig.isSnapshotFilteringEnabled();
-        const processed = shouldSkipFilter ? snapshotTree : await filterSnapshot(snapshotTree, this.step);
+        const shouldSkipFilter = this.options.skipFilter || !this.config.snapshotFilter;
+        const processed = shouldSkipFilter
+            ? snapshotTree
+            : await filterSnapshot(snapshotTree, this.runtimeLogger, this.step, this.config.snapshotTopPercent);
         const minifiedSnapshot = `page snapshot:\n${this.minify(JSON.stringify(processed))}`;
         return this.redactAds(`${await this.getHeader()}\n${minifiedSnapshot}`);
     }
@@ -54,9 +82,10 @@ export class SnapshotService {
             if (!this.page) {
                 throw new Error('Page is not initialized');
             }
+            await this.waitForStableHtml(this.page);
             const rawSnapshot = await this.page.ariaSnapshot({ mode: 'ai' });
             const compressedSnapshot = await this.compress(rawSnapshot);
-            logger.debug(`created aria page snapshot:\n${compressedSnapshot}`);
+            this.runtimeLogger.debug(`created aria page snapshot:\n${compressedSnapshot}`);
             return compressedSnapshot;
         }
         catch (error) {

package/dist/drivers/web/tools/snapshot-service.js.map

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