@mercuryo-ai/agentbrowse 0.2.50

package/dist/commands/action-artifacts.d.ts

@@ -0,0 +1,33 @@
+import type { Page } from 'playwright-core';
+import type { BrowseAction } from './browse-actions.js';
+type TraceController = {
+    finishSuccess(): Promise<void>;
+    finishFailure(artifactDir: string): Promise<string | undefined>;
+};
+export type ActionFailureArtifacts = {
+    dir: string;
+    screenshotPath?: string;
+    htmlPath?: string;
+    tracePath?: string;
+    actionLogPath: string;
+};
+export declare function startActionTrace(page: Page, options?: {
+    suppressSensitiveArtifacts?: boolean;
+}): Promise<TraceController>;
+export declare function captureActionFailureArtifacts(params: {
+    page: Page;
+    targetRef: string;
+    action: BrowseAction;
+    pageRef: string;
+    attempts: string[];
+    locatorStrategy?: string | null;
+    popup: boolean;
+    overlayHandled: boolean;
+    iframe: boolean;
+    jsFallback: boolean;
+    durationMs: number;
+    error: string;
+    finishTrace(artifactDir: string): Promise<string | undefined>;
+}): Promise<ActionFailureArtifacts>;
+export {};
+//# sourceMappingURL=action-artifacts.d.ts.map

package/dist/commands/action-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-artifacts.d.ts","sourceRoot":"","sources":["../../src/commands/action-artifacts.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,KAAK,eAAe,GAAG;IACrB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACjE,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAWF,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,IAAI,EACV,OAAO,GAAE;IACP,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACjC,GACL,OAAO,CAAC,eAAe,CAAC,CAsD1B;AAED,wBAAsB,6BAA6B,CAAC,MAAM,EAAE;IAC1D,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CAC/D,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA4DlC"}

package/dist/commands/action-artifacts.js

@@ -0,0 +1,104 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+function sanitizeSegment(value) {
+    return (value
+        .replace(/[^a-zA-Z0-9._-]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 64) || 'item');
+}
+export async function startActionTrace(page, options = {}) {
+    if (options.suppressSensitiveArtifacts) {
+        return {
+            finishSuccess: async () => { },
+            finishFailure: async () => undefined,
+        };
+    }
+    const tracing = page.context().tracing;
+    if (!tracing?.start || !tracing?.stop) {
+        return {
+            finishSuccess: async () => { },
+            finishFailure: async () => undefined,
+        };
+    }
+    let active = false;
+    try {
+        await tracing.start({ screenshots: true, snapshots: true });
+        active = true;
+    }
+    catch {
+        active = false;
+    }
+    return {
+        finishSuccess: async () => {
+            if (!active)
+                return;
+            active = false;
+            try {
+                await tracing.stop();
+            }
+            catch {
+                // Best effort only.
+            }
+        },
+        finishFailure: async (artifactDir) => {
+            if (!active)
+                return undefined;
+            active = false;
+            const tracePath = path.join(artifactDir, 'trace.zip');
+            try {
+                await tracing.stop({ path: tracePath });
+                return tracePath;
+            }
+            catch {
+                return undefined;
+            }
+        },
+    };
+}
+export async function captureActionFailureArtifacts(params) {
+    const artifactDir = path.join(tmpdir(), 'agentbrowse-artifacts', `act-${Date.now()}-${sanitizeSegment(params.targetRef)}-${sanitizeSegment(params.action)}`);
+    await mkdir(artifactDir, { recursive: true });
+    let screenshotPath;
+    try {
+        screenshotPath = path.join(artifactDir, 'page.png');
+        await params.page.screenshot({ path: screenshotPath, fullPage: true });
+    }
+    catch {
+        screenshotPath = undefined;
+    }
+    let htmlPath;
+    try {
+        htmlPath = path.join(artifactDir, 'page.html');
+        const html = await params.page.content();
+        await writeFile(htmlPath, html, 'utf-8');
+    }
+    catch {
+        htmlPath = undefined;
+    }
+    const tracePath = await params.finishTrace(artifactDir);
+    const actionLogPath = path.join(artifactDir, 'action-log.json');
+    await writeFile(actionLogPath, JSON.stringify({
+        targetRef: params.targetRef,
+        action: params.action,
+        pageRef: params.pageRef,
+        locatorStrategy: params.locatorStrategy ?? undefined,
+        attempts: params.attempts,
+        popup: params.popup,
+        overlayHandled: params.overlayHandled,
+        iframe: params.iframe,
+        jsFallback: params.jsFallback,
+        durationMs: params.durationMs,
+        error: params.error,
+        screenshotPath,
+        htmlPath,
+        tracePath,
+    }, null, 2) + '\n', 'utf-8');
+    return {
+        dir: artifactDir,
+        screenshotPath,
+        htmlPath,
+        tracePath,
+        actionLogPath,
+    };
+}

package/dist/commands/action-execution-guards.d.ts

@@ -0,0 +1,5 @@
+export type ActionExecutionGuards = {
+    assertStillValid?: (stage: string) => Promise<void>;
+};
+export declare function runActionExecutionGuard(guards: ActionExecutionGuards | undefined, stage: string): Promise<void>;
+//# sourceMappingURL=action-execution-guards.d.ts.map

package/dist/commands/action-execution-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-execution-guards.d.ts","sourceRoot":"","sources":["../../src/commands/action-execution-guards.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG;IAClC,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD,CAAC;AAEF,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,qBAAqB,GAAG,SAAS,EACzC,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/commands/action-execution-guards.js

@@ -0,0 +1,3 @@
+export async function runActionExecutionGuard(guards, stage) {
+    await guards?.assertStillValid?.(stage);
+}

package/dist/commands/action-executor-helpers.d.ts

@@ -0,0 +1,21 @@
+import type { Locator, Page } from 'playwright-core';
+export declare const LOCATOR_CLICK_TIMEOUT_MS = 1500;
+export declare const LOCATOR_FILL_TIMEOUT_MS = 1500;
+export declare function looksLikeOverlayInterference(error: unknown): boolean;
+export declare function dismissBlockingOverlay(page: Page, attempts: string[]): Promise<boolean>;
+export declare function applyValueWithJsFallback(locator: Locator, value: string, attempts: string[]): Promise<void>;
+export declare function focusLocator(page: Page, locator: Locator, attempts: string[]): Promise<void>;
+export declare function normalizeFillValue(locator: Locator, value: string, attempts: string[]): Promise<string>;
+export declare function readLocatorCurrentValue(locator: Locator): Promise<string>;
+export declare function planTextFillStrategy(locator: Locator, value: string, attempts: string[]): Promise<{
+    normalizedValue: string;
+    preferSequential: boolean;
+    settleMs: number;
+    initialPhonePrefix: string | null;
+    blurAfterFill: boolean;
+}>;
+export declare function normalizeDigitsOnly(value: string): string;
+export declare function deriveMaskedSequentialValue(value: string, residualValue: string, initialPhonePrefix: string | null, attempts: string[]): string;
+export declare function clearLocatorForReplacement(locator: Locator, attempts: string[]): Promise<void>;
+export declare function blurLocator(locator: Locator, attempts: string[]): Promise<void>;
+//# sourceMappingURL=action-executor-helpers.d.ts.map

package/dist/commands/action-executor-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-executor-helpers.d.ts","sourceRoot":"","sources":["../../src/commands/action-executor-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAgBrD,eAAO,MAAM,wBAAwB,OAAQ,CAAC;AAC9C,eAAO,MAAM,uBAAuB,OAAQ,CAAC;AAkB7C,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAWpE;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAqB7F;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,IAAI,CAAC,CAsCf;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,MAAM,CAAC,CAOjB;AA2GD,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAE/E;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC;IACT,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC,CAqBD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,EACrB,kBAAkB,EAAE,MAAM,GAAG,IAAI,EACjC,QAAQ,EAAE,MAAM,EAAE,GACjB,MAAM,CAkBR;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAarF"}

package/dist/commands/action-executor-helpers.js

@@ -0,0 +1,265 @@
+import { inferComparableValueTypeFromFacts } from '../control-semantics.js';
+const OVERLAY_DISMISS_SELECTORS = [
+    '[aria-label="Close"]',
+    '[aria-label="Dismiss"]',
+    '[data-testid*="close"]',
+    '[data-testid*="dismiss"]',
+    'button:has-text("Close")',
+    'button:has-text("Dismiss")',
+    'button:has-text("Not now")',
+    'button:has-text("No thanks")',
+    'button:has-text("Skip")',
+    'button:has-text("Maybe later")',
+];
+export const LOCATOR_CLICK_TIMEOUT_MS = 1_500;
+export const LOCATOR_FILL_TIMEOUT_MS = 1_500;
+const DATE_MASK_PLACEHOLDER_RE = /(?:^|\b)(?:dd|d|дд|д)\s*[./-]\s*(?:mm|m|мм|м)\s*[./-]\s*(?:yyyy|yyy|yy|y|гггг|гг|г)(?:\b|$)/i;
+const DATE_FIELD_HINT_RE = /\b(?:birth|dob|date|dates|expire|expires|expiry|expir|bday)\b|(?:дата|рожд|срок)/i;
+const ISO_DATE_RE = /^(\d{4})-(\d{2})-(\d{2})$/;
+export function looksLikeOverlayInterference(error) {
+    const message = error instanceof Error ? error.message.toLowerCase() : String(error).toLowerCase();
+    return (message.includes('intercept') ||
+        message.includes('another element') ||
+        message.includes('not receiving pointer events') ||
+        message.includes('obscured') ||
+        message.includes('blocked by') ||
+        message.includes('element click intercepted'));
+}
+export async function dismissBlockingOverlay(page, attempts) {
+    attempts.push('overlay.dismiss.scan');
+    for (const selector of OVERLAY_DISMISS_SELECTORS) {
+        const candidate = page.locator(selector).first();
+        const visible = await candidate.isVisible().catch(() => false);
+        if (!visible) {
+            continue;
+        }
+        attempts.push(`overlay.dismiss:${selector}`);
+        try {
+            await candidate.click({ timeout: LOCATOR_CLICK_TIMEOUT_MS });
+            attempts.push('overlay.dismissed');
+            return true;
+        }
+        catch {
+            continue;
+        }
+    }
+    return false;
+}
+export async function applyValueWithJsFallback(locator, value, attempts) {
+    attempts.push('locator.evaluate.setValue');
+    await locator.evaluate((element, nextValue) => {
+        if (!(element instanceof HTMLElement)) {
+            throw new Error('unsupported_js_value_fallback');
+        }
+        if (element instanceof HTMLInputElement ||
+            element instanceof HTMLTextAreaElement ||
+            element instanceof HTMLSelectElement) {
+            const prototype = element instanceof HTMLInputElement
+                ? HTMLInputElement.prototype
+                : element instanceof HTMLTextAreaElement
+                    ? HTMLTextAreaElement.prototype
+                    : HTMLSelectElement.prototype;
+            const setter = Object.getOwnPropertyDescriptor(prototype, 'value')?.set;
+            if (setter) {
+                setter.call(element, nextValue);
+            }
+            else {
+                element.value = nextValue;
+            }
+            element.dispatchEvent(new Event('input', { bubbles: true }));
+            element.dispatchEvent(new Event('change', { bubbles: true }));
+            return;
+        }
+        if (element.isContentEditable) {
+            element.textContent = nextValue;
+            element.dispatchEvent(new Event('input', { bubbles: true }));
+            element.dispatchEvent(new Event('change', { bubbles: true }));
+            return;
+        }
+        throw new Error('unsupported_js_value_fallback');
+    }, value);
+}
+export async function focusLocator(page, locator, attempts) {
+    attempts.push('locator.click');
+    try {
+        await locator.click({ timeout: LOCATOR_CLICK_TIMEOUT_MS });
+    }
+    catch (error) {
+        if (looksLikeOverlayInterference(error)) {
+            const dismissed = await dismissBlockingOverlay(page, attempts);
+            if (dismissed) {
+                attempts.push('locator.click.retry.afterOverlay');
+                try {
+                    await locator.click({ timeout: LOCATOR_CLICK_TIMEOUT_MS });
+                    return;
+                }
+                catch {
+                    // Ignore focus click failure and fall through.
+                }
+            }
+        }
+        // Ignore focus click failure and let downstream fallback continue.
+    }
+}
+export async function normalizeFillValue(locator, value, attempts) {
+    const metadata = await readTextEntryMetadata(locator);
+    const normalized = normalizeDateLikeValue(value, metadata);
+    if (normalized !== value) {
+        attempts.push('fill.normalize:date-mask');
+    }
+    return normalized;
+}
+function extractPhonePrefix(value) {
+    const raw = (value ?? '').trim();
+    if (!raw.startsWith('+')) {
+        return null;
+    }
+    const explicitBoundary = raw.match(/^\+\d{1,4}(?=[\s(.-]|$)/);
+    if (explicitBoundary) {
+        return explicitBoundary[0];
+    }
+    return null;
+}
+async function readTextEntryMetadata(locator) {
+    const [type, autocomplete, name, role, ariaHasPopup, ariaControls, ariaExpanded, placeholder, id, currentValue,] = await Promise.all([
+        locator.getAttribute?.('type').catch(() => null),
+        locator.getAttribute?.('autocomplete').catch(() => null),
+        locator.getAttribute?.('name').catch(() => null),
+        locator.getAttribute?.('role').catch(() => null),
+        locator.getAttribute?.('aria-haspopup').catch(() => null),
+        locator.getAttribute?.('aria-controls').catch(() => null),
+        locator.getAttribute?.('aria-expanded').catch(() => null),
+        locator.getAttribute?.('placeholder').catch(() => null),
+        locator.getAttribute?.('id').catch(() => null),
+        typeof locator.inputValue === 'function' ? locator.inputValue().catch(() => '') : '',
+    ]);
+    const normalizedType = (type || '').toLowerCase();
+    const normalizedAutocomplete = (autocomplete || '').toLowerCase();
+    const normalizedName = (name || '').toLowerCase();
+    const cardAutocomplete = normalizedAutocomplete.startsWith('cc-');
+    const phoneLike = !cardAutocomplete &&
+        (normalizedType === 'tel' ||
+            normalizedAutocomplete.includes('tel') ||
+            normalizedName.includes('phone'));
+    const comparableValueType = inferComparableValueTypeFromFacts({
+        kind: 'input',
+        role: role || undefined,
+        placeholder: placeholder || undefined,
+        inputName: name || undefined,
+        inputType: type || undefined,
+        autocomplete: autocomplete || undefined,
+    });
+    const dateHintBlob = [type, autocomplete, name, placeholder, id]
+        .filter((value) => typeof value === 'string' && value.trim().length > 0)
+        .join(' ');
+    const nativeDateInput = normalizedType === 'date';
+    const trimmedPlaceholder = (placeholder || '').trim();
+    const dateSeparator = trimmedPlaceholder.includes('/')
+        ? '/'
+        : trimmedPlaceholder.includes('-')
+            ? '-'
+            : '.';
+    const maskedDateLike = !nativeDateInput &&
+        comparableValueType !== 'expiry' &&
+        (DATE_MASK_PLACEHOLDER_RE.test(trimmedPlaceholder) || DATE_FIELD_HINT_RE.test(dateHintBlob));
+    const popupBackedTextEntry = Boolean((ariaControls || '').trim()) ||
+        ['listbox', 'menu'].includes((ariaHasPopup || '').toLowerCase()) ||
+        (role || '').toLowerCase() === 'combobox' ||
+        ariaExpanded !== null;
+    return {
+        phoneLike,
+        popupBackedTextEntry,
+        maskedDateLike,
+        nativeDateInput,
+        dateSeparator,
+        currentValue: currentValue || '',
+        currentPhonePrefix: phoneLike ? extractPhonePrefix(currentValue || '') : null,
+    };
+}
+function normalizeDateLikeValue(value, metadata) {
+    if (metadata.nativeDateInput) {
+        return value;
+    }
+    if (!metadata.maskedDateLike) {
+        return value;
+    }
+    const isoMatch = value.match(ISO_DATE_RE);
+    if (!isoMatch) {
+        return value;
+    }
+    const [, year, month, day] = isoMatch;
+    return `${day}${metadata.dateSeparator}${month}${metadata.dateSeparator}${year}`;
+}
+export async function readLocatorCurrentValue(locator) {
+    return typeof locator.inputValue === 'function' ? locator.inputValue().catch(() => '') : '';
+}
+export async function planTextFillStrategy(locator, value, attempts) {
+    const metadata = await readTextEntryMetadata(locator);
+    if (metadata.phoneLike) {
+        attempts.push('fill.strategy:masked-sequential');
+    }
+    else if (metadata.maskedDateLike) {
+        attempts.push('fill.strategy:date-sequential');
+    }
+    else if (metadata.popupBackedTextEntry) {
+        attempts.push('fill.strategy:popup-sequential');
+    }
+    return {
+        normalizedValue: normalizeDateLikeValue(value, metadata),
+        preferSequential: metadata.phoneLike || metadata.popupBackedTextEntry || metadata.maskedDateLike,
+        settleMs: metadata.phoneLike
+            ? 120
+            : metadata.popupBackedTextEntry || metadata.maskedDateLike
+                ? 80
+                : 0,
+        initialPhonePrefix: metadata.currentPhonePrefix,
+        blurAfterFill: metadata.maskedDateLike,
+    };
+}
+export function normalizeDigitsOnly(value) {
+    return value.replace(/\s+/g, '');
+}
+export function deriveMaskedSequentialValue(value, residualValue, initialPhonePrefix, attempts) {
+    const normalizedIncoming = normalizeDigitsOnly(value);
+    if (!/^\d{5,}$/.test(normalizedIncoming) || normalizedIncoming.startsWith('+')) {
+        return value;
+    }
+    const residualPrefix = extractPhonePrefix(residualValue);
+    if (residualPrefix) {
+        attempts.push(`fill.masked.residual-prefix:${residualPrefix}`);
+        return value;
+    }
+    if (initialPhonePrefix) {
+        attempts.push(`fill.masked.initial-prefix:${initialPhonePrefix}`);
+        return `${initialPhonePrefix}${normalizedIncoming}`;
+    }
+    return value;
+}
+export async function clearLocatorForReplacement(locator, attempts) {
+    if (typeof locator.selectText === 'function') {
+        attempts.push('locator.selectText');
+        try {
+            await locator.selectText();
+            attempts.push('locator.press:Backspace');
+            await locator.press('Backspace');
+            return;
+        }
+        catch {
+            // Fall through to downstream replacement strategies.
+        }
+    }
+}
+export async function blurLocator(locator, attempts) {
+    if (typeof locator.blur === 'function') {
+        attempts.push('locator.blur');
+        try {
+            await locator.blur();
+            return;
+        }
+        catch {
+            // Fall through to DOM-event fallback.
+        }
+    }
+    attempts.push('locator.dispatchEvent:blur');
+    await locator.dispatchEvent?.('blur').catch(() => { });
+}

package/dist/commands/action-executor.d.ts

@@ -0,0 +1,14 @@
+import type { Locator, Page } from 'playwright-core';
+import type { TargetControlFamily } from '../runtime-state.js';
+import type { BrowseAction } from './browse-actions.js';
+import type { LocatorRoot } from './action-fallbacks.js';
+import type { ActionExecutionGuards } from './action-execution-guards.js';
+import type { ClickActivationStrategy } from './click-activation-policy.js';
+type ActionExecutionOptions = {
+    beforeClickRetry?: () => Promise<void>;
+    guards?: ActionExecutionGuards;
+    clickActivationStrategy?: ClickActivationStrategy;
+};
+export declare function applyActionWithFallbacks(page: Page, root: LocatorRoot, locator: Locator, action: BrowseAction, value: string | undefined, attempts: string[], family?: TargetControlFamily, options?: ActionExecutionOptions): Promise<boolean>;
+export {};
+//# sourceMappingURL=action-executor.d.ts.map

package/dist/commands/action-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-executor.d.ts","sourceRoot":"","sources":["../../src/commands/action-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAc5E,KAAK,sBAAsB,GAAG;IAC5B,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;CACnD,CAAC;AAEF,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,CAAC,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,OAAO,CAAC,CAsDlB"}

package/dist/commands/action-executor.js

@@ -0,0 +1,46 @@
+import { applyValueWithJsFallback, blurLocator, clearLocatorForReplacement, focusLocator, normalizeFillValue, } from './action-executor-helpers.js';
+import { applyEditableClickAction, applyTriggerAction } from './click-action-executor.js';
+import { applyDatepickerAction } from './datepicker-action-executor.js';
+import { applySelectLikeAction } from './select-action-executor.js';
+import { applyStructuredGridAction } from './structured-grid-action-executor.js';
+import { applyTextFillAction, applyTypeAction } from './text-input-action-executor.js';
+export async function applyActionWithFallbacks(page, root, locator, action, value, attempts, family, options) {
+    switch (action) {
+        case 'click':
+            if (family === 'structured-grid') {
+                return applyStructuredGridAction(page, locator, attempts);
+            }
+            if (family === 'trigger') {
+                return applyTriggerAction(page, locator, attempts, {
+                    beforeRetry: options?.beforeClickRetry,
+                    guards: options?.guards,
+                    clickActivationStrategy: options?.clickActivationStrategy,
+                });
+            }
+            return applyEditableClickAction(page, locator, attempts, {
+                beforeRetry: options?.beforeClickRetry,
+                guards: options?.guards,
+            });
+        case 'fill':
+            return family === 'datepicker'
+                ? applyDatepickerAction(page, locator, value, attempts, {
+                    normalizeFillValue,
+                    focusLocator,
+                    clearLocatorForReplacement,
+                    applyValueWithJsFallback,
+                    blurLocator,
+                }, options?.guards)
+                : applyTextFillAction(page, locator, value, attempts, options?.guards);
+        case 'type':
+            return applyTypeAction(page, locator, value, attempts, options?.guards);
+        case 'select':
+            return applySelectLikeAction(page, root, locator, value, attempts, {
+                focusLocator,
+                clearLocatorForReplacement,
+            }, options?.guards);
+        case 'press':
+            attempts.push('locator.press');
+            await locator.press(value);
+            return false;
+    }
+}

package/dist/commands/action-fallbacks.d.ts

@@ -0,0 +1,6 @@
+import type { FrameLocator, Locator, Page } from 'playwright-core';
+import type { LocatorCandidate } from '../runtime-state.js';
+export type LocatorRoot = Page | FrameLocator | Locator;
+export declare function resolveLocatorRoot(page: Page, framePath?: ReadonlyArray<string>): LocatorRoot;
+export declare function buildLocator(root: LocatorRoot, candidate: LocatorCandidate): Locator | null;
+//# sourceMappingURL=action-fallbacks.d.ts.map

package/dist/commands/action-fallbacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-fallbacks.d.ts","sourceRoot":"","sources":["../../src/commands/action-fallbacks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,YAAY,GAAG,OAAO,CAAC;AAcxD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,WAAW,CAU7F;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,gBAAgB,GAAG,OAAO,GAAG,IAAI,CAsB3F"}

package/dist/commands/action-fallbacks.js

@@ -0,0 +1,43 @@
+function escapeSelectorAttributeValue(value) {
+    return JSON.stringify(value);
+}
+function buildTestIdSelector(value, attribute) {
+    const escapedValue = escapeSelectorAttributeValue(value);
+    if (attribute) {
+        return `[${attribute}=${escapedValue}]`;
+    }
+    return `[data-testid=${escapedValue}], [data-test-id=${escapedValue}]`;
+}
+export function resolveLocatorRoot(page, framePath) {
+    if (!framePath || framePath.length === 0) {
+        return page;
+    }
+    let root = page;
+    for (const frameSelector of framePath) {
+        root = root.frameLocator(frameSelector);
+    }
+    return root;
+}
+export function buildLocator(root, candidate) {
+    switch (candidate.strategy) {
+        case 'role': {
+            const role = candidate.value;
+            return root.getByRole(role, candidate.name ? { name: candidate.name } : undefined);
+        }
+        case 'label':
+            return root.getByLabel(candidate.value);
+        case 'placeholder':
+            return root.getByPlaceholder(candidate.value);
+        case 'text':
+            return root.getByText(candidate.value);
+        case 'title':
+            return root.getByTitle(candidate.value);
+        case 'testId':
+            return root.locator(buildTestIdSelector(candidate.value, candidate.attribute));
+        case 'css':
+        case 'xpath':
+            return root.locator(candidate.value);
+        default:
+            return null;
+    }
+}

package/dist/commands/action-result-resolution.d.ts

@@ -0,0 +1,17 @@
+import { type AcceptanceProbe, type PageObservation } from './action-acceptance.js';
+export type SubmitResultClaimKind = 'hard_result' | 'hard_blocker' | 'intermediate_progress' | 'soft_result_candidate' | 'noisy_change';
+export type SubmitResultClaim = {
+    kind: SubmitResultClaimKind;
+    source: string;
+    reason: string;
+    ownerScopeRef?: string;
+};
+export type SubmitResultResolution = {
+    finalVerdict: 'outcome' | 'blocked' | 'progress' | 'none';
+    claims: SubmitResultClaim[];
+    decisiveClaims: SubmitResultClaim[];
+    acceptAsProgress: boolean;
+};
+export declare function reduceSubmitResultClaims(claims: ReadonlyArray<SubmitResultClaim>): Omit<SubmitResultResolution, 'claims' | 'acceptAsProgress'>;
+export declare function resolveSubmitResult(probe: AcceptanceProbe, afterPageObservation: PageObservation | null): Promise<SubmitResultResolution>;
+//# sourceMappingURL=action-result-resolution.d.ts.map

package/dist/commands/action-result-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-result-resolution.d.ts","sourceRoot":"","sources":["../../src/commands/action-result-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAC;AAGhC,MAAM,MAAM,qBAAqB,GAC7B,aAAa,GACb,cAAc,GACd,uBAAuB,GACvB,uBAAuB,GACvB,cAAc,CAAC;AAEnB,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,qBAAqB,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,YAAY,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IAC1D,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,cAAc,EAAE,iBAAiB,EAAE,CAAC;IACpC,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,aAAa,CAAC,iBAAiB,CAAC,GACvC,IAAI,CAAC,sBAAsB,EAAE,QAAQ,GAAG,kBAAkB,CAAC,CA+B7D;AA2BD,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,eAAe,EACtB,oBAAoB,EAAE,eAAe,GAAG,IAAI,GAC3C,OAAO,CAAC,sBAAsB,CAAC,CA8FjC"}