@nuanu-ai/agentbrowse 0.2.47 → 0.2.49

package/dist/commands/act.test-harness.d.ts

@@ -2,13 +2,19 @@ import { vi } from 'vitest';
 import type { BrowseSession } from '../session.js';
 type ViMock = ReturnType<typeof vi.fn>;
 export declare const captureActionFailureArtifactsMock: ViMock;
+export declare const appendCommandLifecycleEventBestEffortMock: ViMock;
+export declare const captureStepSnapshotBestEffortMock: ViMock;
 export declare const connectStagehandMock: ViMock;
 export declare const connectOverCDPMock: ViMock;
+export declare const exportRunStepToOtlpHttpJsonBestEffortMock: ViMock;
+export declare const finishRunStepMock: ViMock;
 export declare const outputContractFailureMock: ViMock;
 export declare const outputErrorMock: ViMock;
 export declare const outputFailureMock: ViMock;
 export declare const outputJSONMock: ViMock;
+export declare const saveArtifactManifestMock: ViMock;
 export declare const saveSessionMock: ViMock;
+export declare const startRunStepMock: ViMock;
 export declare const startActionTraceMock: ViMock;
 export declare const act: typeof import("./act.js").act;
 export declare function makeSession(): BrowseSession;

package/dist/commands/act.test-harness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"act.test-harness.d.ts","sourceRoot":"","sources":["../../src/commands/act.test-harness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,EAAE,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,KAAK,MAAM,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;AA6BvC,eAAO,MAAM,iCAAiC,EAAE,MAAgD,CAAC;AACjG,eAAO,MAAM,oBAAoB,EAAE,MAAmC,CAAC;AACvE,eAAO,MAAM,kBAAkB,EAAE,MAAiC,CAAC;AACnE,eAAO,MAAM,yBAAyB,EAAE,MAAwC,CAAC;AACjF,eAAO,MAAM,eAAe,EAAE,MAA8B,CAAC;AAC7D,eAAO,MAAM,iBAAiB,EAAE,MAAgC,CAAC;AACjE,eAAO,MAAM,cAAc,EAAE,MAA6B,CAAC;AAC3D,eAAO,MAAM,eAAe,EAAE,MAA8B,CAAC;AAC7D,eAAO,MAAM,oBAAoB,EAAE,MAAmC,CAAC;AAgCvE,eAAO,MAAQ,GAAG,+BAA6B,CAAC;AAEhD,wBAAgB,WAAW,IAAI,aAAa,CAW3C;AAED,wBAAgB,WAAW,CAAC,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,GAAG,CA2KxE;AAED,wBAAgB,qBAAqB,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,GAAG,GAAG,CAM7F;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAqB1C"}
+{"version":3,"file":"act.test-harness.d.ts","sourceRoot":"","sources":["../../src/commands/act.test-harness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,EAAE,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,KAAK,MAAM,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;AAwCvC,eAAO,MAAM,iCAAiC,EAAE,MAAgD,CAAC;AACjG,eAAO,MAAM,yCAAyC,EAAE,MACP,CAAC;AAClD,eAAO,MAAM,iCAAiC,EAAE,MAAgD,CAAC;AACjG,eAAO,MAAM,oBAAoB,EAAE,MAAmC,CAAC;AACvE,eAAO,MAAM,kBAAkB,EAAE,MAAiC,CAAC;AACnE,eAAO,MAAM,yCAAyC,EAAE,MACP,CAAC;AAClD,eAAO,MAAM,iBAAiB,EAAE,MAAgC,CAAC;AACjE,eAAO,MAAM,yBAAyB,EAAE,MAAwC,CAAC;AACjF,eAAO,MAAM,eAAe,EAAE,MAA8B,CAAC;AAC7D,eAAO,MAAM,iBAAiB,EAAE,MAAgC,CAAC;AACjE,eAAO,MAAM,cAAc,EAAE,MAA6B,CAAC;AAC3D,eAAO,MAAM,wBAAwB,EAAE,MAAuC,CAAC;AAC/E,eAAO,MAAM,eAAe,EAAE,MAA8B,CAAC;AAC7D,eAAO,MAAM,gBAAgB,EAAE,MAA+B,CAAC;AAC/D,eAAO,MAAM,oBAAoB,EAAE,MAAmC,CAAC;AA+CvE,eAAO,MAAQ,GAAG,+BAA6B,CAAC;AAEhD,wBAAgB,WAAW,IAAI,aAAa,CAY3C;AAED,wBAAgB,WAAW,CAAC,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,GAAG,CA2KxE;AAED,wBAAgB,qBAAqB,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,GAAG,GAAG,CAM7F;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAkC1C"}

package/dist/commands/act.test-harness.js

@@ -1,6 +1,7 @@
 import { afterEach, beforeEach, vi } from 'vitest';
-import { registerPage } from '../runtime-state.js';
+import { registerPage } from '../runtime-page-state.js';
 const mocks = vi.hoisted(() => ({
+    appendCommandLifecycleEventBestEffortMock: vi.fn(),
     captureActionFailureArtifactsMock: vi.fn(async () => ({
         dir: '/tmp/agentbrowse-artifacts/act-test',
         screenshotPath: '/tmp/agentbrowse-artifacts/act-test/page.png',
@@ -8,8 +9,14 @@ const mocks = vi.hoisted(() => ({
         tracePath: '/tmp/agentbrowse-artifacts/act-test/trace.zip',
         actionLogPath: '/tmp/agentbrowse-artifacts/act-test/action-log.json',
     })),
+    captureStepSnapshotBestEffortMock: vi.fn(),
     connectStagehandMock: vi.fn(),
     connectOverCDPMock: vi.fn(),
+    exportRunStepToOtlpHttpJsonBestEffortMock: vi.fn(async () => ({
+        attempted: false,
+        reason: 'config_missing',
+    })),
+    finishRunStepMock: vi.fn(),
     outputContractFailureMock: vi.fn((payload) => {
         throw new Error(`outputContractFailure:${JSON.stringify(payload)}`);
     }),
@@ -20,20 +27,30 @@ const mocks = vi.hoisted(() => ({
         throw new Error(result.error);
     }),
     outputJSONMock: vi.fn(),
+    saveArtifactManifestMock: vi.fn(),
     saveSessionMock: vi.fn(),
+    startRunStepMock: vi.fn(() => ({
+        stepId: 'step_act_1',
+    })),
     startActionTraceMock: vi.fn(async () => ({
         finishSuccess: async () => { },
         finishFailure: async () => '/tmp/agentbrowse-artifacts/act-test/trace.zip',
     })),
 }));
 export const captureActionFailureArtifactsMock = mocks.captureActionFailureArtifactsMock;
+export const appendCommandLifecycleEventBestEffortMock = mocks.appendCommandLifecycleEventBestEffortMock;
+export const captureStepSnapshotBestEffortMock = mocks.captureStepSnapshotBestEffortMock;
 export const connectStagehandMock = mocks.connectStagehandMock;
 export const connectOverCDPMock = mocks.connectOverCDPMock;
+export const exportRunStepToOtlpHttpJsonBestEffortMock = mocks.exportRunStepToOtlpHttpJsonBestEffortMock;
+export const finishRunStepMock = mocks.finishRunStepMock;
 export const outputContractFailureMock = mocks.outputContractFailureMock;
 export const outputErrorMock = mocks.outputErrorMock;
 export const outputFailureMock = mocks.outputFailureMock;
 export const outputJSONMock = mocks.outputJSONMock;
+export const saveArtifactManifestMock = mocks.saveArtifactManifestMock;
 export const saveSessionMock = mocks.saveSessionMock;
+export const startRunStepMock = mocks.startRunStepMock;
 export const startActionTraceMock = mocks.startActionTraceMock;
 vi.mock('playwright-core', () => ({
     chromium: {
@@ -53,6 +70,18 @@ vi.mock('./action-artifacts.js', () => ({
     captureActionFailureArtifacts: captureActionFailureArtifactsMock,
     startActionTrace: startActionTraceMock,
 }));
+vi.mock('../run-store.js', () => ({
+    finishRunStep: finishRunStepMock,
+    saveArtifactManifest: saveArtifactManifestMock,
+    startRunStep: startRunStepMock,
+}));
+vi.mock('../run-observability.js', () => ({
+    appendCommandLifecycleEventBestEffort: appendCommandLifecycleEventBestEffortMock,
+    captureStepSnapshotBestEffort: captureStepSnapshotBestEffortMock,
+}));
+vi.mock('../otel-exporter.js', () => ({
+    exportRunStepToOtlpHttpJsonBestEffort: exportRunStepToOtlpHttpJsonBestEffortMock,
+}));
 vi.mock('../session.js', async () => {
     const actual = await vi.importActual('../session.js');
     return {
@@ -65,6 +94,7 @@ export function makeSession() {
     const session = {
         cdpUrl: 'ws://localhost:9222/devtools/browser/test',
         pid: 1,
+        activeRunId: 'run_123',
         launchedAt: new Date(0).toISOString(),
     };
     registerPage(session, {
@@ -242,9 +272,17 @@ export function makeLocatorCollection(...locators) {
 export function installActTestHooks() {
     beforeEach(() => {
         vi.useRealTimers();
+        appendCommandLifecycleEventBestEffortMock.mockReset();
+        captureStepSnapshotBestEffortMock.mockReset();
         connectOverCDPMock.mockReset();
         connectStagehandMock.mockReset();
         captureActionFailureArtifactsMock.mockClear();
+        exportRunStepToOtlpHttpJsonBestEffortMock.mockReset();
+        exportRunStepToOtlpHttpJsonBestEffortMock.mockResolvedValue({
+            attempted: false,
+            reason: 'config_missing',
+        });
+        finishRunStepMock.mockReset();
         outputContractFailureMock.mockReset();
         outputContractFailureMock.mockImplementation((payload) => {
             throw new Error(`outputContractFailure:${JSON.stringify(payload)}`);
@@ -252,7 +290,12 @@ export function installActTestHooks() {
         outputErrorMock.mockClear();
         outputFailureMock.mockClear();
         outputJSONMock.mockClear();
+        saveArtifactManifestMock.mockReset();
         saveSessionMock.mockReset();
+        startRunStepMock.mockReset();
+        startRunStepMock.mockReturnValue({
+            stepId: 'step_act_1',
+        });
         startActionTraceMock.mockClear();
     });
     afterEach(() => {

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

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

package/dist/commands/action-acceptance.js

@@ -57,6 +57,105 @@ const ACTION_CANDIDATE_PRIORITY = {
 };
 const ACCEPTANCE_POLL_INTERVAL_MS = 100;
 const ACCEPTANCE_POLL_TIMEOUT_MS = 2_500;
+const ASSOCIATED_CHOICE_STATE_HELPER_SCRIPT = String.raw `
+  const ownerWindowOf = (node) => node?.ownerDocument?.defaultView ?? window;
+  const isHTMLElementNode = (value) => {
+    const view = ownerWindowOf(value);
+    return Boolean(view && value instanceof view.HTMLElement);
+  };
+  const isHTMLInputNode = (value) => {
+    const view = ownerWindowOf(value);
+    return Boolean(view && value instanceof view.HTMLInputElement);
+  };
+  const isHTMLLabelNode = (value) => {
+    const view = ownerWindowOf(value);
+    return Boolean(view && value instanceof view.HTMLLabelElement);
+  };
+  const isChoiceInput = (candidate) => {
+    if (!isHTMLInputNode(candidate)) {
+      return false;
+    }
+    const type = (candidate.type || '').toLowerCase();
+    return type === 'radio' || type === 'checkbox';
+  };
+  const associatedLabelControlOf = (candidate) => {
+    if (!isHTMLLabelNode(candidate)) {
+      return undefined;
+    }
+
+    const directControl = candidate.control;
+    if (isChoiceInput(directControl)) {
+      return directControl;
+    }
+
+    const nestedControl = candidate.querySelector?.('input');
+    return isChoiceInput(nestedControl) ? nestedControl : undefined;
+  };
+  const hiddenChoiceSiblingControlOf = (candidate) => {
+    if (!isHTMLElementNode(candidate)) {
+      return undefined;
+    }
+
+    const parent = candidate.parentElement;
+    if (!isHTMLElementNode(parent)) {
+      return undefined;
+    }
+
+    const hiddenChoiceSiblings = Array.from(parent.children).filter((sibling) => {
+      if (sibling === candidate || !isChoiceInput(sibling)) {
+        return false;
+      }
+
+      const style = ownerWindowOf(sibling).getComputedStyle(sibling);
+      const rect = sibling.getBoundingClientRect();
+      return (
+        style.display === 'none' ||
+        style.visibility === 'hidden' ||
+        style.pointerEvents === 'none' ||
+        Number(style.opacity || '1') < 0.05 ||
+        rect.width < 4 ||
+        rect.height < 4
+      );
+    });
+
+    if (hiddenChoiceSiblings.length !== 1) {
+      return undefined;
+    }
+
+    const visibleNonChoiceSiblings = Array.from(parent.children).filter((sibling) => {
+      if (sibling === hiddenChoiceSiblings[0] || !isHTMLElementNode(sibling)) {
+        return false;
+      }
+
+      const style = ownerWindowOf(sibling).getComputedStyle(sibling);
+      const rect = sibling.getBoundingClientRect();
+      return (
+        style.display !== 'none' &&
+        style.visibility !== 'hidden' &&
+        style.visibility !== 'collapse' &&
+        rect.width > 0 &&
+        rect.height > 0
+      );
+    });
+
+    if (visibleNonChoiceSiblings.length !== 1 || visibleNonChoiceSiblings[0] !== candidate) {
+      return undefined;
+    }
+
+    return hiddenChoiceSiblings[0];
+  };
+  const associatedChoiceControl =
+    (isChoiceInput(element) ? element : undefined) ||
+    associatedLabelControlOf(element) ||
+    hiddenChoiceSiblingControlOf(element);
+  if (!associatedChoiceControl) {
+    return null;
+  }
+
+  return {
+    checked: associatedChoiceControl.indeterminate ? 'mixed' : associatedChoiceControl.checked,
+  };
+`;
 const PAGE_OBSERVATION_SCRIPT = String.raw `(() => {
   const normalizeText = (value) => (value ?? '').replace(/\s+/g, ' ').trim();
   const sampleText = (value, limit) => {
@@ -731,6 +830,14 @@ function acceptancePolicyForAction(target, action) {
     if (action === 'press' && isEditableLikeTarget(target)) {
         return undefined;
     }
+    if ((action === 'fill' || action === 'type') &&
+        target.controlFamily === 'select' &&
+        target.allowedActions.includes('fill') &&
+        target.allowedActions.includes('select') &&
+        (target.kind ?? '').toLowerCase() !== 'select' &&
+        (target.semantics?.role ?? '').toLowerCase() === 'combobox') {
+        return 'selection';
+    }
     if (action === 'select') {
         if (target.controlFamily === 'datepicker') {
             return 'date-selection';
@@ -1147,6 +1254,11 @@ export async function captureLocatorState(locator, keys) {
         };
     })
         .catch(() => ({ selected: null, current: null, pressed: null }));
+    const associatedChoiceState = keys.includes('checked')
+        ? await locator
+            .evaluate((element, source) => Function('element', source)(element), ASSOCIATED_CHOICE_STATE_HELPER_SCRIPT)
+            .catch(() => null)
+        : null;
     for (const key of keys) {
         switch (key) {
             case 'checked': {
@@ -1164,6 +1276,9 @@ export async function captureLocatorState(locator, keys) {
                     state.checked = false;
                 else if (ariaChecked === 'mixed')
                     state.checked = 'mixed';
+                else if (associatedChoiceState && typeof associatedChoiceState === 'object') {
+                    state.checked = associatedChoiceState.checked;
+                }
                 break;
             }
             case 'selected': {

package/dist/commands/captcha-solve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"captcha-solve.d.ts","sourceRoot":"","sources":["../../src/commands/captcha-solve.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAOnD,wBAAsB,YAAY,CAChC,OAAO,EAAE,aAAa,GAAG,IAAI,EAC7B,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC,CA6Cf"}
+{"version":3,"file":"captcha-solve.d.ts","sourceRoot":"","sources":["../../src/commands/captcha-solve.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAcnD,wBAAsB,YAAY,CAChC,OAAO,EAAE,aAAa,GAAG,IAAI,EAC7B,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC,CAiHf"}

package/dist/commands/captcha-solve.js

@@ -3,7 +3,11 @@
  */
 import { solveCaptchasByCdp } from '../solver/captcha-runtime.js';
 import { supportsCaptchaSolve } from '../session.js';
+import { withApiTraceContext } from '../command-api-tracing.js';
 import { info, outputContractFailure, outputJSON } from '../output.js';
+import { exportRunStepToOtlpHttpJsonBestEffort } from '../otel-exporter.js';
+import { appendCommandLifecycleEventBestEffort, captureStepSnapshotBestEffort, } from '../run-observability.js';
+import { finishRunStep, startRunStep } from '../run-store.js';
 import { applyAgentpayGatewayEnv, resolveAgentpayGatewayConfig } from '../agentpay-gateway.js';
 const DEFAULT_TIMEOUT_SECONDS = 90;
 export async function captchaSolve(session, timeoutSeconds) {
@@ -27,23 +31,86 @@ export async function captchaSolve(session, timeoutSeconds) {
     applyAgentpayGatewayEnv(gateway);
     const cdpUrl = session.cdpUrl;
     const sessionProxy = session.transport?.proxyMode === 'proxy' ? session.transport.proxy : undefined;
+    const solveStep = session.activeRunId
+        ? startRunStep({
+            runId: session.activeRunId,
+            command: 'solve-captcha',
+            input: {
+                timeoutSeconds: timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS,
+                sharedTransport: Boolean(sessionProxy),
+            },
+            refs: {
+                pageRef: session.runtime?.currentPageRef,
+            },
+        })
+        : null;
+    captureStepSnapshotBestEffort({
+        session,
+        step: solveStep,
+        phase: 'before',
+        pageRef: session.runtime?.currentPageRef,
+    });
+    appendCommandLifecycleEventBestEffort({
+        step: solveStep,
+        phase: 'started',
+        attributes: {
+            pageRef: session.runtime?.currentPageRef,
+            timeoutSeconds: timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS,
+            sharedTransport: Boolean(sessionProxy),
+        },
+    });
     const timeoutMs = Math.max(1, timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS) * 1000;
     info(`[captcha] solve-captcha started (timeout ${Math.ceil(timeoutMs / 1000)}s, endpoint ${cdpUrl})`);
-    const result = await solveCaptchasByCdp(cdpUrl, gateway.apiKey, {
-        timeoutMs,
-        solveTimeoutMs: Math.min(timeoutMs, 120000),
-        apiUrl: gateway.apiUrl,
-        proxy: sessionProxy,
-        sharedTransport: Boolean(sessionProxy),
-        onProgress: (message) => info(message),
-    });
-    outputJSON({
-        success: true,
-        solved: result.solved,
-        verified: result.verified,
-        unresolved: result.unresolved,
-        unresolvedCaptchas: result.unresolvedCaptchas,
-        detected: result.detected,
-        timedOut: result.timedOut,
+    return withApiTraceContext({
+        runId: session.activeRunId,
+        stepId: solveStep?.stepId,
+        command: 'solve-captcha',
+    }, async () => {
+        const result = await solveCaptchasByCdp(cdpUrl, gateway.apiKey, {
+            timeoutMs,
+            solveTimeoutMs: Math.min(timeoutMs, 120000),
+            apiUrl: gateway.apiUrl,
+            proxy: sessionProxy,
+            sharedTransport: Boolean(sessionProxy),
+            onProgress: (message) => info(message),
+        });
+        captureStepSnapshotBestEffort({
+            session,
+            step: solveStep,
+            phase: 'after',
+            pageRef: session.runtime?.currentPageRef,
+        });
+        appendCommandLifecycleEventBestEffort({
+            step: solveStep,
+            phase: 'completed',
+            attributes: {
+                outcomeType: result.timedOut ? 'captcha_solve_timed_out' : 'captcha_solve_completed',
+                solved: result.solved,
+                verified: result.verified,
+                unresolved: result.unresolved,
+                detected: result.detected,
+            },
+        });
+        if (session.activeRunId && solveStep?.stepId) {
+            finishRunStep({
+                runId: session.activeRunId,
+                stepId: solveStep.stepId,
+                success: !result.timedOut,
+                outcomeType: result.timedOut ? 'captcha_solve_timed_out' : 'captcha_solve_completed',
+                message: result.timedOut
+                    ? 'Captcha solving timed out.'
+                    : 'Captcha solving completed.',
+            });
+            await exportRunStepToOtlpHttpJsonBestEffort(session.activeRunId, solveStep.stepId);
+        }
+        outputJSON({
+            success: true,
+            solved: result.solved,
+            verified: result.verified,
+            unresolved: result.unresolved,
+            unresolvedCaptchas: result.unresolvedCaptchas,
+            detected: result.detected,
+            timedOut: result.timedOut,
+        });
     });
 }

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

@@ -5,7 +5,6 @@ type ClickRetryOptions = {
     beforeRetry?: () => Promise<void>;
     guards?: ActionExecutionGuards;
     clickActivationStrategy?: ClickActivationStrategy;
-    focusStrategy?: 'iframe-only' | 'active-control';
 };
 export declare function applyEditableClickAction(page: Page, locator: Locator, attempts: string[], options?: ClickRetryOptions): Promise<boolean>;
 export declare function applyTriggerAction(page: Page, locator: Locator, attempts: string[], options?: ClickRetryOptions): Promise<boolean>;

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

@@ -1 +1 @@
-{"version":3,"file":"click-action-executor.d.ts","sourceRoot":"","sources":["../../src/commands/click-action-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAMrD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAA2B,KAAK,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAEnG,KAAK,iBAAiB,GAAG;IACvB,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;IAClD,aAAa,CAAC,EAAE,aAAa,GAAG,gBAAgB,CAAC;CAClD,CAAC;AA0LF,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,OAAO,CAAC,CAKlB;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,OAAO,CAAC,CAKlB"}
+{"version":3,"file":"click-action-executor.d.ts","sourceRoot":"","sources":["../../src/commands/click-action-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAMrD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAA2B,KAAK,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAEnG,KAAK,iBAAiB,GAAG;IACvB,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;CACnD,CAAC;AAiIF,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,OAAO,CAAC,CAElB;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,OAAO,CAAC,CAElB"}

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

@@ -1,75 +1,32 @@
 import { LOCATOR_CLICK_TIMEOUT_MS, dismissBlockingOverlay, looksLikeOverlayInterference, } from './action-executor-helpers.js';
 import { runActionExecutionGuard } from './action-execution-guards.js';
-const DEFAULT_FOCUS_ALIGNMENT_RESULT = {
-    focused: false,
-    kind: null,
-};
-function normalizeFocusAlignmentResult(result) {
-    if (result === true) {
-        return {
-            focused: true,
-            kind: 'iframe',
-        };
-    }
-    if (!result || typeof result !== 'object') {
-        return DEFAULT_FOCUS_ALIGNMENT_RESULT;
-    }
-    const candidate = result;
-    const focused = candidate.focused === true;
-    if (!focused) {
-        return DEFAULT_FOCUS_ALIGNMENT_RESULT;
+async function handoffFocusFromActiveIframe(locator, attempts) {
+    const focused = await locator
+        .evaluate((element) => {
+        if (!(element instanceof HTMLElement)) {
+            return false;
+        }
+        const active = element.ownerDocument.activeElement;
+        if (!(active instanceof HTMLIFrameElement)) {
+            return false;
+        }
+        element.focus();
+        return element.ownerDocument.activeElement === element;
+    })
+        .catch(() => false);
+    if (focused) {
+        attempts.push('locator.focus.handoff-from-iframe');
     }
-    return {
-        focused: true,
-        kind: candidate.kind === 'iframe' || candidate.kind === 'control' ? candidate.kind : 'control',
-    };
+    return focused;
 }
-async function alignTargetFocusBeforeClick(locator, attempts, focusStrategy) {
-    const focusProbeResult = await (focusStrategy === 'iframe-only'
-        ? locator.evaluate((element) => {
-            if (!(element instanceof HTMLElement)) {
-                return { focused: false, kind: null };
-            }
-            const active = element.ownerDocument.activeElement;
-            if (!(active instanceof HTMLElement) || active === element) {
-                return { focused: false, kind: null };
-            }
-            if (active === element.ownerDocument.body ||
-                active === element.ownerDocument.documentElement ||
-                !(active instanceof HTMLIFrameElement)) {
-                return { focused: false, kind: null };
-            }
-            element.focus();
-            return {
-                focused: element.ownerDocument.activeElement === element,
-                kind: 'iframe',
-            };
-        })
-        : locator.evaluate((element) => {
-            if (!(element instanceof HTMLElement)) {
-                return { focused: false, kind: null };
-            }
-            const active = element.ownerDocument.activeElement;
-            if (!(active instanceof HTMLElement) || active === element) {
-                return { focused: false, kind: null };
-            }
-            if (active === element.ownerDocument.body ||
-                active === element.ownerDocument.documentElement) {
-                return { focused: false, kind: null };
-            }
-            const kind = active instanceof HTMLIFrameElement ? 'iframe' : 'control';
-            element.focus();
-            return {
-                focused: element.ownerDocument.activeElement === element,
-                kind,
-            };
-        })).catch(() => DEFAULT_FOCUS_ALIGNMENT_RESULT);
-    const focusResult = normalizeFocusAlignmentResult(focusProbeResult);
-    if (focusResult.focused) {
-        attempts.push(focusResult.kind === 'iframe'
-            ? 'locator.focus.handoff-from-iframe'
-            : 'locator.focus.before-click');
-    }
+async function waitForPostHandoffQuiescence(page, attempts, options) {
+    await runActionExecutionGuard(options?.guards, 'click.focus-handoff.quiescence');
+    await page
+        .evaluate(() => new Promise((resolve) => {
+        window.requestAnimationFrame(() => resolve());
+    }))
+        .catch(() => undefined);
+    attempts.push('locator.focus.handoff-quiescence.raf');
 }
 async function ensureLocatorRetryReady(locator, error, options) {
     await runActionExecutionGuard(options?.guards, 'click.before-retry');
@@ -80,7 +37,10 @@ async function ensureLocatorRetryReady(locator, error, options) {
     }
 }
 async function applyClickSequence(page, locator, attempts, options) {
-    await alignTargetFocusBeforeClick(locator, attempts, options?.focusStrategy ?? 'iframe-only');
+    const handedOffFocus = await handoffFocusFromActiveIframe(locator, attempts);
+    if (handedOffFocus) {
+        await waitForPostHandoffQuiescence(page, attempts, options);
+    }
     if (options?.clickActivationStrategy === 'dom') {
         await runActionExecutionGuard(options?.guards, 'click.evaluate.primary');
         attempts.push('locator.evaluate.click.primary');
@@ -144,14 +104,8 @@ async function applyClickSequence(page, locator, attempts, options) {
     }
 }
 export async function applyEditableClickAction(page, locator, attempts, options) {
-    return applyClickSequence(page, locator, attempts, {
-        ...options,
-        focusStrategy: options?.focusStrategy ?? 'iframe-only',
-    });
+    return applyClickSequence(page, locator, attempts, options);
 }
 export async function applyTriggerAction(page, locator, attempts, options) {
-    return applyClickSequence(page, locator, attempts, {
-        ...options,
-        focusStrategy: options?.focusStrategy ?? 'active-control',
-    });
+    return applyClickSequence(page, locator, attempts, options);
 }

package/dist/commands/close.d.ts

@@ -6,9 +6,9 @@ export type CloseSuccessResult = {
 };
 export type CloseFailureResult = {
     success: false;
-    error: 'browser_close_failed';
-    outcomeType: 'blocked';
-    message: 'Browser close failed.';
+    error: 'browser_close_failed' | 'workflow_session_unavailable' | 'workflow_run_unavailable' | 'workflow_step_unavailable' | 'workflow_session_complete_failed';
+    outcomeType: 'blocked' | 'failed';
+    message: 'Browser close failed.' | 'Browser closed but workflow session completion failed.';
     reason: string;
 };
 export type CloseResult = CloseSuccessResult | CloseFailureResult;

package/dist/commands/close.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"close.d.ts","sourceRoot":"","sources":["../../src/commands/close.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,IAAI,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,sBAAsB,CAAC;IAC9B,WAAW,EAAE,SAAS,CAAC;IACvB,OAAO,EAAE,uBAAuB,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;AAclE,wBAAsB,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC,CAwBlD"}
+{"version":3,"file":"close.d.ts","sourceRoot":"","sources":["../../src/commands/close.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkBH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,IAAI,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EACD,sBAAsB,GACtB,8BAA8B,GAC9B,0BAA0B,GAC1B,2BAA2B,GAC3B,kCAAkC,CAAC;IACvC,WAAW,EAAE,SAAS,GAAG,QAAQ,CAAC;IAClC,OAAO,EAAE,uBAAuB,GAAG,wDAAwD,CAAC;IAC5F,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;AA8ElE,wBAAsB,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC,CA6IlD"}