@mercuryo-ai/agentbrowse 0.2.50

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

@@ -0,0 +1,93 @@
+import type { Locator, Page } from 'playwright-core';
+import type { BrowseSession } from '../session.js';
+import { getTarget } from '../runtime-state.js';
+import type { SurfaceDescriptor, TargetDescriptor } from '../runtime-state.js';
+import { type ComparableValueType } from '../control-semantics.js';
+import type { BrowseAction } from './browse-actions.js';
+export type PageObservation = {
+    url: string;
+    title: string;
+    contentHash: string | null;
+    structureHash: string | null;
+    submitSignalHash: string | null;
+    resultSignalHash: string | null;
+    validationBlockerCount: number;
+};
+type TargetStateKey = 'selected' | 'checked' | 'expanded' | 'pressed' | 'current' | 'focused';
+type LocatorStateObservation = Partial<Record<TargetStateKey, string | boolean>>;
+export type AcceptanceProbe = {
+    policy: NonNullable<TargetDescriptor['acceptancePolicy']>;
+    page: Page;
+    target: TargetDescriptor;
+    action: BrowseAction;
+    surface: SurfaceDescriptor | null;
+    ownerTarget: TargetDescriptor | null;
+    ownerSurface: SurfaceDescriptor | null;
+    beforePage: PageObservation | null;
+    beforeLocator: LocatorStateObservation | null;
+    beforeContextHash: string | null;
+    beforeReadLocator: LocatorStateObservation | null;
+    beforeReadContextHash: string | null;
+    trackedStateKeys: TargetStateKey[];
+    locator: Locator;
+    readLocator: Locator;
+    readLocators: Locator[];
+    surfaceLocator: Locator | null;
+    expectedValue: string | null;
+    beforeValue: string | null;
+    comparableValueType?: ComparableValueType;
+    ownerLocator: Locator | null;
+    beforeOwnerValue: string | null;
+    beforeSurfaceContextHash: string | null;
+    beforeFollowUpSurfaceHash: string | null;
+};
+export type AcceptanceProbeResult = {
+    accepted: boolean;
+    afterPageObservation: PageObservation | null;
+    polls: number;
+};
+export type NoObservableProgressObservations = {
+    visibleMessages: string[];
+    invalidFields: string[];
+    targetState?: {
+        disabled?: boolean;
+        readonly?: boolean;
+    };
+};
+export declare function captureSubmitFollowUpSurfaceHash(page: Page): Promise<string | null>;
+export declare function rankLocatorCandidates(candidates: ReadonlyArray<NonNullable<ReturnType<typeof getTarget>>['locatorCandidates'][number]>, action: BrowseAction): import("../runtime-state.js").LocatorCandidate[];
+export declare function shouldVerifyObservableProgress(target: TargetDescriptor, action: BrowseAction): boolean;
+export declare function capturePageObservation(page: Page): Promise<PageObservation>;
+export declare function captureLocatorContextHash(locator: Locator): Promise<string | null>;
+declare function comparableValueTypeForTarget(target: TargetDescriptor): ComparableValueType | undefined;
+declare function normalizeComparableValue(value: string | null, comparableValueType?: ComparableValueType): string;
+declare function valuesMatchExpected(expected: string | null, actual: string | null, comparableValueType?: ComparableValueType, options?: {
+    allowCompactActualSequence?: boolean;
+}): boolean;
+export declare const __testComparableValues: {
+    comparableValueTypeForTarget: typeof comparableValueTypeForTarget;
+    normalizeComparableValue: typeof normalizeComparableValue;
+    valuesMatchExpected: typeof valuesMatchExpected;
+};
+export declare function captureLocatorState(locator: Locator, keys: ReadonlyArray<TargetStateKey>): Promise<LocatorStateObservation | null>;
+export declare function locatorStateChanged(before: LocatorStateObservation | null, after: LocatorStateObservation | null): boolean;
+export declare function pageObservationChanged(before: PageObservation | null, after: PageObservation | null): boolean;
+export declare function genericClickObservationChanged(before: PageObservation | null, after: PageObservation | null): boolean;
+export declare function submitObservationChanged(before: PageObservation | null, after: PageObservation | null): boolean;
+export declare function diagnoseNoObservableProgress(page: Page, locator: Locator): Promise<NoObservableProgressObservations | null>;
+export declare function createAcceptanceProbe(args: {
+    session: BrowseSession;
+    page: Page;
+    target: TargetDescriptor;
+    action: BrowseAction;
+    actionValue: string | undefined;
+    locator: Locator;
+    beforePageObservation: PageObservation | null;
+}): Promise<AcceptanceProbe | null>;
+export declare function evaluateAcceptanceProbe(probe: AcceptanceProbe, afterPageObservation: PageObservation | null): Promise<boolean>;
+export declare function waitForAcceptanceProbe(probe: AcceptanceProbe, options?: {
+    timeoutMs?: number;
+    intervalMs?: number;
+}): Promise<AcceptanceProbeResult>;
+export {};
+//# sourceMappingURL=action-acceptance.d.ts.map

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

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