@riddledc/riddle-proof 0.7.197 → 0.7.198

package/README.md

@@ -406,7 +406,7 @@ when body matching overrides sequence order.
 `target.setup_actions` is optional. Use it when the meaningful proof surface
 appears only after a picker, tab, login stub, storage seed, form fill,
 transport control, or other bounded interaction. Supported setup actions are
-`click`, `tap`, `drag`, `press`, `key_down`, `key_up`, `fill`, `set_input_value`, `set_range_value`,
+`click`, `tap`, `tap_until`, `drag`, `press`, `key_down`, `key_up`, `fill`, `set_input_value`, `set_range_value`,
 `deterministic_runtime`, `canvas_signature`, `assert_text_visible`, `assert_text_absent`,
 `assert_selector_count`, `assert_window_value`, `assert_window_number`,
 `local_storage`, `session_storage`, `clear_storage`, `clear_console`,
@@ -436,6 +436,14 @@ It requires `selector`, defaults to a touch tap at the target center, and
 accepts `x` / `y` or `from_x` / `from_y` plus `coordinate_mode: "ratio"` for
 element-relative coordinates. Set `pointer_type` to `mouse`, `touch`, or `pen`
 when the proof must distinguish input modality.
+Use `tap_until` for gameplay loops where the proof should tap a visible target
+until a browser-state predicate is satisfied. It accepts the same selector,
+coordinate, and pointer options as `tap`, plus `until_path`,
+`until_expected_value`, `max_taps` / `max_calls` from 1 to 100, and optional
+`interval_ms`. The action stops early when the predicate matches and records one
+compact receipt with `tap_count`, final `until_value`, and input dispatch
+details, so long canvas interaction loops do not need dozens of repeated setup
+actions.
 Use `set_range_value` for HTML range inputs and React-controlled sliders. It
 accepts aliases such as `set-slider-value`, requires `selector` plus `value`,
 uses the native input value setter, dispatches bubbling `input` and `change`
@@ -531,7 +539,9 @@ actions stay visible. Click actions with `click_count` greater than `1` are
 included in clicked-target evidence and rolled up as `click_count_action_total`
 and `click_count_value_total`. Repeated selector runs such as long gameplay
 button loops are also grouped as compact `same-selector` click-sequence
-receipts with click totals and ordinals. Setup receipt sampling favors both
+receipts with click totals and ordinals. `tap_until` actions are summarized as
+one compact receipt with total taps and the final predicate value, which is the
+preferred shape for long canvas gameplay loops. Setup receipt sampling favors both
 first and last per-viewport receipts before filling remaining space, so late
 lifecycle phases such as terminal or restart remain visible in compact
 summaries.

package/dist/{chunk-EYLIXKE2.js → chunk-DL6UB4N6.js}

@@ -45,6 +45,7 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
 var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "click",
   "tap",
+  "tap_until",
   "drag",
   "press",
   "key_down",
@@ -615,6 +616,28 @@ function profileSetupTapReceipts(results) {
     reason: result.reason ?? result.error ?? null
   }));
 }
+function profileSetupTapUntilReceipts(results) {
+  return results.filter((result) => profileSetupResultAction(result) === "tap_until").map((result) => ({
+    ordinal: result.ordinal ?? null,
+    ok: result.ok !== false,
+    selector: result.selector ?? null,
+    frame_selector: result.frame_selector ?? null,
+    pointer_type: result.pointer_type ?? null,
+    input_dispatch: result.input_dispatch ?? null,
+    coordinate_mode: result.coordinate_mode ?? null,
+    x: result.x ?? null,
+    y: result.y ?? null,
+    duration_ms: result.duration_ms ?? null,
+    until_path: result.until_path ?? null,
+    until_value: result.until_value ?? null,
+    until_expected_value: result.until_expected_value ?? null,
+    tap_count: result.tap_count ?? null,
+    max_taps: result.max_taps ?? result.max_calls ?? null,
+    interval_ms: result.interval_ms ?? null,
+    timeout_ms: result.timeout_ms ?? null,
+    reason: result.reason ?? result.error ?? null
+  }));
+}
 function profileSetupKeyboardReceipts(results) {
   return results.filter((result) => ["press", "key_down", "key_up"].includes(profileSetupResultAction(result))).map((result) => ({
     action: profileSetupResultAction(result),
@@ -790,6 +813,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
       const sampledDragReceipts = sampleProfileSetupSummaryItems(dragReceipts, 8);
       const tapReceipts = profileSetupTapReceipts(results);
       const sampledTapReceipts = sampleProfileSetupSummaryItems(tapReceipts, 8);
+      const tapUntilReceipts = profileSetupTapUntilReceipts(results);
+      const tapUntilTapCounts = tapUntilReceipts.map((result) => typeof result.tap_count === "number" && Number.isFinite(result.tap_count) ? result.tap_count : void 0).filter((value) => value !== void 0);
+      const sampledTapUntilReceipts = sampleProfileSetupSummaryItems(tapUntilReceipts, 8);
       const keyboardReceipts = profileSetupKeyboardReceipts(results);
       const sampledKeyboardReceipts = sampleProfileSetupSummaryItems(keyboardReceipts, 8);
       const canvasSignatureReceipts = profileSetupCanvasSignatureReceipts(results);
@@ -862,6 +888,10 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
         tap_total: tapReceipts.length,
         tap_truncated: tapReceipts.length > sampledTapReceipts.length,
         tap: sampledTapReceipts,
+        tap_until_total: tapUntilReceipts.length,
+        tap_until_tap_total: tapUntilTapCounts.reduce((sum, value) => sum + value, 0),
+        tap_until_truncated: tapUntilReceipts.length > sampledTapUntilReceipts.length,
+        tap_until: sampledTapUntilReceipts,
         keyboard_total: keyboardReceipts.length,
         keyboard_truncated: keyboardReceipts.length > sampledKeyboardReceipts.length,
         keyboard: sampledKeyboardReceipts,
@@ -923,7 +953,7 @@ function isSupportedCheckType(value) {
 }
 function normalizeSetupActionType(value, index) {
   const normalizedInput = String(value || "").trim().replace(/-/g, "_");
-  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "reset_console" || normalizedInput === "clear_browser_console" || normalizedInput === "reset_browser_console" ? "clear_console" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "pointer_tap" || normalizedInput === "touch_tap" || normalizedInput === "canvas_tap" ? "tap" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput === "keyboard_down" || normalizedInput === "key_down" || normalizedInput === "keydown" || normalizedInput === "press_down" ? "key_down" : normalizedInput === "keyboard_up" || normalizedInput === "key_up" || normalizedInput === "keyup" || normalizedInput === "press_up" || normalizedInput === "release_key" || normalizedInput === "key_release" ? "key_up" : normalizedInput === "set_slider_value" || normalizedInput === "slider_value" || normalizedInput === "set_slider" || normalizedInput === "set_range" || normalizedInput === "range_value" || normalizedInput === "range_input" || normalizedInput === "set_range_input" ? "set_range_value" : normalizedInput === "deterministic_runtime" || normalizedInput === "mock_runtime" || normalizedInput === "mock_random" || normalizedInput === "mock_random_queue" || normalizedInput === "seed_random_queue" || normalizedInput === "set_random_queue" || normalizedInput === "mock_clock" || normalizedInput === "set_mock_clock" || normalizedInput === "set_runtime_determinism" || normalizedInput === "runtime_determinism" ? "deterministic_runtime" : normalizedInput === "canvas_hash" || normalizedInput === "capture_canvas_hash" || normalizedInput === "capture_canvas_signature" || normalizedInput === "canvas_state_signature" ? "canvas_signature" : normalizedInput === "capture_screenshot" || normalizedInput === "save_screenshot" || normalizedInput === "setup_screenshot" ? "screenshot" : normalizedInput === "accept_dialog" || normalizedInput === "accept_dialogs" || normalizedInput === "confirm_dialog" || normalizedInput === "set_dialog_response" ? "dialog_response" : normalizedInput === "dismiss_dialog" || normalizedInput === "dismiss_dialogs" || normalizedInput === "cancel_dialog" ? "dialog_response" : normalizedInput === "window_call_until" || normalizedInput === "call_until" || normalizedInput === "window_call_repeat_until" || normalizedInput === "repeat_window_call_until" ? "window_call_until" : normalizedInput === "window_evaluate" || normalizedInput === "browser_eval" || normalizedInput === "browser_evaluate" || normalizedInput === "evaluate_script" || normalizedInput === "profile_script" ? "window_eval" : normalizedInput;
+  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "reset_console" || normalizedInput === "clear_browser_console" || normalizedInput === "reset_browser_console" ? "clear_console" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "pointer_tap" || normalizedInput === "touch_tap" || normalizedInput === "canvas_tap" ? "tap" : normalizedInput === "tap_until" || normalizedInput === "pointer_tap_until" || normalizedInput === "touch_tap_until" || normalizedInput === "canvas_tap_until" || normalizedInput === "tap_repeat_until" || normalizedInput === "repeat_tap_until" ? "tap_until" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput === "keyboard_down" || normalizedInput === "key_down" || normalizedInput === "keydown" || normalizedInput === "press_down" ? "key_down" : normalizedInput === "keyboard_up" || normalizedInput === "key_up" || normalizedInput === "keyup" || normalizedInput === "press_up" || normalizedInput === "release_key" || normalizedInput === "key_release" ? "key_up" : normalizedInput === "set_slider_value" || normalizedInput === "slider_value" || normalizedInput === "set_slider" || normalizedInput === "set_range" || normalizedInput === "range_value" || normalizedInput === "range_input" || normalizedInput === "set_range_input" ? "set_range_value" : normalizedInput === "deterministic_runtime" || normalizedInput === "mock_runtime" || normalizedInput === "mock_random" || normalizedInput === "mock_random_queue" || normalizedInput === "seed_random_queue" || normalizedInput === "set_random_queue" || normalizedInput === "mock_clock" || normalizedInput === "set_mock_clock" || normalizedInput === "set_runtime_determinism" || normalizedInput === "runtime_determinism" ? "deterministic_runtime" : normalizedInput === "canvas_hash" || normalizedInput === "capture_canvas_hash" || normalizedInput === "capture_canvas_signature" || normalizedInput === "canvas_state_signature" ? "canvas_signature" : normalizedInput === "capture_screenshot" || normalizedInput === "save_screenshot" || normalizedInput === "setup_screenshot" ? "screenshot" : normalizedInput === "accept_dialog" || normalizedInput === "accept_dialogs" || normalizedInput === "confirm_dialog" || normalizedInput === "set_dialog_response" ? "dialog_response" : normalizedInput === "dismiss_dialog" || normalizedInput === "dismiss_dialogs" || normalizedInput === "cancel_dialog" ? "dialog_response" : normalizedInput === "window_call_until" || normalizedInput === "call_until" || normalizedInput === "window_call_repeat_until" || normalizedInput === "repeat_window_call_until" ? "window_call_until" : normalizedInput === "window_evaluate" || normalizedInput === "browser_eval" || normalizedInput === "browser_evaluate" || normalizedInput === "evaluate_script" || normalizedInput === "profile_script" ? "window_eval" : normalizedInput;
   if (RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.includes(normalized)) {
     return normalized;
   }
@@ -1005,8 +1035,8 @@ function normalizeSetupActionCoordinateMode(value, index) {
 }
 function normalizeSetupActionPointerType(value, type, index) {
   if (value === void 0 || value === null || value === "") return void 0;
-  if (type !== "drag" && type !== "tap") {
-    throw new Error(`target.setup_actions[${index}].pointer_type is only supported for drag/tap actions.`);
+  if (type !== "drag" && type !== "tap" && type !== "tap_until") {
+    throw new Error(`target.setup_actions[${index}].pointer_type is only supported for drag/tap/tap_until actions.`);
   }
   const normalized = String(value).trim().replace(/-/g, "_").toLowerCase();
   if (normalized === "mouse") return "mouse";
@@ -1085,11 +1115,11 @@ function normalizeSetupAction(input, index) {
   if (frameIndex !== void 0 && (!Number.isInteger(frameIndex) || frameIndex < 0)) {
     throw new Error(`target.setup_actions[${index}].frame_index must be a non-negative integer.`);
   }
-  if ((type === "click" || type === "tap" || type === "drag" || type === "fill" || type === "set_input_value" || type === "set_range_value" || type === "canvas_signature" || type === "wait_for_selector" || type === "wait_for_text" || type === "assert_text_visible" || type === "assert_text_absent" || type === "assert_selector_count") && !selector) {
+  if ((type === "click" || type === "tap" || type === "tap_until" || type === "drag" || type === "fill" || type === "set_input_value" || type === "set_range_value" || type === "canvas_signature" || type === "wait_for_selector" || type === "wait_for_text" || type === "assert_text_visible" || type === "assert_text_absent" || type === "assert_selector_count") && !selector) {
     throw new Error(`target.setup_actions[${index}] ${type} requires selector.`);
   }
-  const fromX = type === "click" || type === "tap" ? numberValue(valueFromOwn(input, "from_x", "fromX", "x", "click_x", "clickX", "start_x", "startX", "x1")) : numberValue(valueFromOwn(input, "from_x", "fromX", "start_x", "startX", "x1"));
-  const fromY = type === "click" || type === "tap" ? numberValue(valueFromOwn(input, "from_y", "fromY", "y", "click_y", "clickY", "start_y", "startY", "y1")) : numberValue(valueFromOwn(input, "from_y", "fromY", "start_y", "startY", "y1"));
+  const fromX = type === "click" || type === "tap" || type === "tap_until" ? numberValue(valueFromOwn(input, "from_x", "fromX", "x", "click_x", "clickX", "start_x", "startX", "x1")) : numberValue(valueFromOwn(input, "from_x", "fromX", "start_x", "startX", "x1"));
+  const fromY = type === "click" || type === "tap" || type === "tap_until" ? numberValue(valueFromOwn(input, "from_y", "fromY", "y", "click_y", "clickY", "start_y", "startY", "y1")) : numberValue(valueFromOwn(input, "from_y", "fromY", "start_y", "startY", "y1"));
   const toX = numberValue(valueFromOwn(input, "to_x", "toX", "end_x", "endX", "x2"));
   const toY = numberValue(valueFromOwn(input, "to_y", "toY", "end_y", "endY", "y2"));
   const coordinateMode = normalizeSetupActionCoordinateMode(valueFromOwn(input, "coordinate_mode", "coordinateMode", "coords", "units"), index);
@@ -1114,18 +1144,18 @@ function normalizeSetupAction(input, index) {
       }
     }
   }
-  if (type === "tap") {
+  if (type === "tap" || type === "tap_until") {
     const hasTapCoordinate = fromX !== void 0 || fromY !== void 0;
     if (hasTapCoordinate && (fromX === void 0 || fromY === void 0)) {
-      throw new Error(`target.setup_actions[${index}] tap coordinates require both x and y.`);
+      throw new Error(`target.setup_actions[${index}] ${type} coordinates require both x and y.`);
     }
     if (hasTapCoordinate && fromX !== void 0 && fromY !== void 0) {
       const tapCoordinates = [fromX, fromY];
       if (coordinateMode === "ratio" && tapCoordinates.some((value2) => value2 < 0 || value2 > 1)) {
-        throw new Error(`target.setup_actions[${index}] tap ratio coordinates must be between 0 and 1.`);
+        throw new Error(`target.setup_actions[${index}] ${type} ratio coordinates must be between 0 and 1.`);
       }
       if ((coordinateMode === void 0 || coordinateMode === "pixels") && tapCoordinates.some((value2) => value2 < 0)) {
-        throw new Error(`target.setup_actions[${index}] tap pixel coordinates must be non-negative.`);
+        throw new Error(`target.setup_actions[${index}] ${type} pixel coordinates must be non-negative.`);
       }
     }
   }
@@ -1231,7 +1261,7 @@ function normalizeSetupAction(input, index) {
   const captureReturn = input.capture_return === false || input.captureReturn === false || input.include_return === false || input.includeReturn === false || input.omit_return === true || input.omitReturn === true ? false : void 0;
   const untilPath = stringFromOwn(input, "until_path", "untilPath", "until_state_path", "untilStatePath", "until_window_path", "untilWindowPath", "until");
   const hasUntilExpectedValue = hasOwn(input, "until_expected_value") || hasOwn(input, "untilExpectedValue") || hasOwn(input, "until_expected") || hasOwn(input, "untilExpected") || hasOwn(input, "until_value") || hasOwn(input, "untilValue") || hasOwn(input, "expected_value") || hasOwn(input, "expectedValue") || hasOwn(input, "expected");
-  if (type === "window_call_until") {
+  if (type === "window_call_until" || type === "tap_until") {
     if (!untilPath) {
       throw new Error(`target.setup_actions[${index}] ${type} requires until_path.`);
     }
@@ -1239,12 +1269,12 @@ function normalizeSetupAction(input, index) {
       throw new Error(`target.setup_actions[${index}] ${type} requires until_expected_value.`);
     }
   }
-  const maxCalls = numberValue(valueFromOwn(input, "max_calls", "maxCalls", "max_attempts", "maxAttempts", "attempts"));
-  if (type === "window_call_until" && (maxCalls === void 0 || !Number.isInteger(maxCalls) || maxCalls < 1 || maxCalls > 100)) {
+  const maxCalls = numberValue(valueFromOwn(input, "max_calls", "maxCalls", "max_attempts", "maxAttempts", "attempts", "max_taps", "maxTaps", "tap_limit", "tapLimit"));
+  if ((type === "window_call_until" || type === "tap_until") && (maxCalls === void 0 || !Number.isInteger(maxCalls) || maxCalls < 1 || maxCalls > 100)) {
     throw new Error(`target.setup_actions[${index}].max_calls must be an integer from 1 to 100.`);
   }
   const intervalMs = numberValue(valueFromOwn(input, "interval_ms", "intervalMs", "poll_ms", "pollMs", "call_interval_ms", "callIntervalMs"));
-  if (type === "window_call_until" && intervalMs !== void 0 && (!Number.isInteger(intervalMs) || intervalMs < 0 || intervalMs > 5e3)) {
+  if ((type === "window_call_until" || type === "tap_until") && intervalMs !== void 0 && (!Number.isInteger(intervalMs) || intervalMs < 0 || intervalMs > 5e3)) {
     throw new Error(`target.setup_actions[${index}].interval_ms must be an integer from 0 to 5000.`);
   }
   const steps = numberValue(input.steps);
@@ -4510,6 +4540,30 @@ function profileSetupTapReceipts(results) {
       reason: result.reason || result.error || null,
     }));
 }
+function profileSetupTapUntilReceipts(results) {
+  return (results || [])
+    .filter((result) => result && profileSetupResultAction(result) === "tap_until")
+    .map((result) => ({
+      ordinal: result.ordinal ?? null,
+      ok: result.ok !== false,
+      selector: result.selector ?? null,
+      frame_selector: result.frame_selector ?? null,
+      pointer_type: result.pointer_type ?? null,
+      input_dispatch: result.input_dispatch ?? null,
+      coordinate_mode: result.coordinate_mode ?? null,
+      x: result.x ?? null,
+      y: result.y ?? null,
+      duration_ms: result.duration_ms ?? null,
+      until_path: result.until_path ?? null,
+      until_value: result.until_value ?? null,
+      until_expected_value: result.until_expected_value ?? null,
+      tap_count: result.tap_count ?? null,
+      max_taps: result.max_taps ?? result.max_calls ?? null,
+      interval_ms: result.interval_ms ?? null,
+      timeout_ms: result.timeout_ms ?? null,
+      reason: result.reason || result.error || null,
+    }));
+}
 function profileSetupKeyboardReceipts(results) {
   return (results || [])
     .filter((result) => result && ["press", "key_down", "key_up"].includes(profileSetupResultAction(result)))
@@ -4712,6 +4766,11 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
       const sampledDragReceipts = sampleProfileSetupSummaryItems(dragReceipts, 8);
       const tapReceipts = profileSetupTapReceipts(results);
       const sampledTapReceipts = sampleProfileSetupSummaryItems(tapReceipts, 8);
+      const tapUntilReceipts = profileSetupTapUntilReceipts(results);
+      const tapUntilTapCounts = tapUntilReceipts
+        .map((result) => typeof result.tap_count === "number" && Number.isFinite(result.tap_count) ? result.tap_count : undefined)
+        .filter((value) => value !== undefined);
+      const sampledTapUntilReceipts = sampleProfileSetupSummaryItems(tapUntilReceipts, 8);
       const keyboardReceipts = profileSetupKeyboardReceipts(results);
       const sampledKeyboardReceipts = sampleProfileSetupSummaryItems(keyboardReceipts, 8);
       const canvasSignatureReceipts = profileSetupCanvasSignatureReceipts(results);
@@ -4794,6 +4853,10 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         tap_total: tapReceipts.length,
         tap_truncated: tapReceipts.length > sampledTapReceipts.length,
         tap: sampledTapReceipts,
+        tap_until_total: tapUntilReceipts.length,
+        tap_until_tap_total: tapUntilTapCounts.reduce((sum, value) => sum + value, 0),
+        tap_until_truncated: tapUntilReceipts.length > sampledTapUntilReceipts.length,
+        tap_until: sampledTapUntilReceipts,
         keyboard_total: keyboardReceipts.length,
         keyboard_truncated: keyboardReceipts.length > sampledKeyboardReceipts.length,
         keyboard: sampledKeyboardReceipts,
@@ -5740,6 +5803,108 @@ async function waitForAnyVisibleSelector(context, selector, timeout) {
   }
   throw new Error("No visible match for selector " + selector + ": " + lastReason);
 }
+async function dispatchSetupTapPoint(point, pointerType, durationMs) {
+  if (pointerType === "touch" || pointerType === "pen") {
+    const client = await page.context().newCDPSession(page);
+    try {
+      if (pointerType === "touch") {
+        const touchPoint = {
+          x: point.x,
+          y: point.y,
+          radiusX: 1,
+          radiusY: 1,
+          force: 1,
+          id: 11,
+        };
+        await client.send("Input.dispatchTouchEvent", {
+          type: "touchStart",
+          touchPoints: [touchPoint],
+        });
+        if (durationMs) await page.waitForTimeout(durationMs);
+        await client.send("Input.dispatchTouchEvent", {
+          type: "touchEnd",
+          touchPoints: [],
+        });
+      } else {
+        await client.send("Input.dispatchMouseEvent", {
+          type: "mousePressed",
+          x: point.x,
+          y: point.y,
+          button: "left",
+          buttons: 1,
+          clickCount: 1,
+          pointerType: "pen",
+        });
+        if (durationMs) await page.waitForTimeout(durationMs);
+        await client.send("Input.dispatchMouseEvent", {
+          type: "mouseReleased",
+          x: point.x,
+          y: point.y,
+          button: "left",
+          buttons: 0,
+          clickCount: 1,
+          pointerType: "pen",
+        });
+      }
+    } finally {
+      await client.detach().catch(() => {});
+    }
+  } else {
+    await page.mouse.click(point.x, point.y);
+  }
+}
+async function resolveSetupTapTarget(action, base, scope, timeout) {
+  const locator = scope.context.locator(action.selector);
+  const count = await locator.count();
+  if (!count) return { result: { ...base, ...setupScopeEvidence(scope), reason: "selector_not_found", count } };
+  const targetIndex = Number.isInteger(action.index) ? action.index : 0;
+  if (targetIndex < 0 || targetIndex >= count) return { result: { ...base, ...setupScopeEvidence(scope), reason: "index_out_of_range", count, target_index: targetIndex } };
+  const target = locator.nth(targetIndex);
+  await target.waitFor({ state: "visible", timeout });
+  const box = await target.boundingBox();
+  if (!box) return { result: { ...base, ...setupScopeEvidence(scope), reason: "bounding_box_unavailable", count, target_index: targetIndex } };
+  const fromX = setupFiniteNumber(action.from_x ?? action.fromX ?? action.x ?? action.click_x ?? action.clickX);
+  const fromY = setupFiniteNumber(action.from_y ?? action.fromY ?? action.y ?? action.click_y ?? action.clickY);
+  const hasTapPosition = fromX !== undefined || fromY !== undefined;
+  if (hasTapPosition && (fromX === undefined || fromY === undefined)) return { result: { ...base, ...setupScopeEvidence(scope), reason: "missing_tap_coordinates", count, target_index: targetIndex } };
+  const mode = String(action.coordinate_mode || action.coordinateMode || (hasTapPosition ? "pixels" : "ratio")).trim();
+  if (hasTapPosition && mode === "ratio" && [fromX, fromY].some((value) => value < 0 || value > 1)) return { result: { ...base, ...setupScopeEvidence(scope), reason: "invalid_ratio_coordinates", count, target_index: targetIndex } };
+  if (hasTapPosition && mode !== "ratio" && [fromX, fromY].some((value) => value < 0)) return { result: { ...base, ...setupScopeEvidence(scope), reason: "invalid_pixel_coordinates", count, target_index: targetIndex } };
+  const coordinate = (value, size) => mode === "ratio" ? value * size : value;
+  const localX = hasTapPosition && fromX !== undefined ? fromX : 0.5;
+  const localY = hasTapPosition && fromY !== undefined ? fromY : 0.5;
+  const point = {
+    x: box.x + coordinate(localX, box.width),
+    y: box.y + coordinate(localY, box.height),
+  };
+  const durationMs = setupNumber(action.duration_ms ?? action.durationMs, 0);
+  const pointerType = String(action.pointer_type || action.pointerType || "touch").trim().toLowerCase();
+  return {
+    target: {
+      count,
+      targetIndex,
+      point,
+      mode,
+      fromX,
+      fromY,
+      hasTapPosition,
+      pointerType,
+      durationMs,
+    },
+  };
+}
+function setupTapTargetEvidence(tapTarget) {
+  return {
+    count: tapTarget.count,
+    target_index: tapTarget.targetIndex,
+    coordinate_mode: tapTarget.hasTapPosition ? tapTarget.mode : undefined,
+    x: tapTarget.hasTapPosition ? tapTarget.fromX : undefined,
+    y: tapTarget.hasTapPosition ? tapTarget.fromY : undefined,
+    pointer_type: tapTarget.pointerType,
+    input_dispatch: tapTarget.pointerType === "touch" || tapTarget.pointerType === "pen" ? "cdp" : "playwright_mouse",
+    duration_ms: tapTarget.durationMs || undefined,
+  };
+}
 function setupHasOwn(action, key) {
   return Boolean(action) && Object.keys(action).includes(key);
 }
@@ -6342,91 +6507,108 @@ async function executeSetupAction(action, ordinal, viewport) {
     if (type === "tap") {
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
-      const locator = scope.context.locator(action.selector);
-      const count = await locator.count();
-      if (!count) return { ...base, ...setupScopeEvidence(scope), reason: "selector_not_found", count };
-      const targetIndex = Number.isInteger(action.index) ? action.index : 0;
-      if (targetIndex < 0 || targetIndex >= count) return { ...base, ...setupScopeEvidence(scope), reason: "index_out_of_range", count, target_index: targetIndex };
-      const target = locator.nth(targetIndex);
-      await target.waitFor({ state: "visible", timeout });
-      const box = await target.boundingBox();
-      if (!box) return { ...base, ...setupScopeEvidence(scope), reason: "bounding_box_unavailable", count, target_index: targetIndex };
-      const fromX = setupFiniteNumber(action.from_x ?? action.fromX ?? action.x ?? action.click_x ?? action.clickX);
-      const fromY = setupFiniteNumber(action.from_y ?? action.fromY ?? action.y ?? action.click_y ?? action.clickY);
-      const hasTapPosition = fromX !== undefined || fromY !== undefined;
-      if (hasTapPosition && (fromX === undefined || fromY === undefined)) return { ...base, ...setupScopeEvidence(scope), reason: "missing_tap_coordinates", count, target_index: targetIndex };
-      const mode = String(action.coordinate_mode || action.coordinateMode || (hasTapPosition ? "pixels" : "ratio")).trim();
-      if (hasTapPosition && mode === "ratio" && [fromX, fromY].some((value) => value < 0 || value > 1)) return { ...base, ...setupScopeEvidence(scope), reason: "invalid_ratio_coordinates", count, target_index: targetIndex };
-      if (hasTapPosition && mode !== "ratio" && [fromX, fromY].some((value) => value < 0)) return { ...base, ...setupScopeEvidence(scope), reason: "invalid_pixel_coordinates", count, target_index: targetIndex };
-      const coordinate = (value, size) => mode === "ratio" ? value * size : value;
-      const localX = hasTapPosition && fromX !== undefined ? fromX : 0.5;
-      const localY = hasTapPosition && fromY !== undefined ? fromY : 0.5;
-      const point = {
-        x: box.x + coordinate(localX, box.width),
-        y: box.y + coordinate(localY, box.height),
+      const prepared = await resolveSetupTapTarget(action, base, scope, timeout);
+      if (prepared.result) return prepared.result;
+      await dispatchSetupTapPoint(prepared.target.point, prepared.target.pointerType, prepared.target.durationMs);
+      return {
+        ...base,
+        ...setupScopeEvidence(scope),
+        ok: true,
+        ...setupTapTargetEvidence(prepared.target),
       };
-      const durationMs = setupNumber(action.duration_ms ?? action.durationMs, 0);
-      const pointerType = String(action.pointer_type || action.pointerType || "touch").trim().toLowerCase();
-      if (pointerType === "touch" || pointerType === "pen") {
-        const client = await page.context().newCDPSession(page);
-        try {
-          if (pointerType === "touch") {
-            const touchPoint = {
-              x: point.x,
-              y: point.y,
-              radiusX: 1,
-              radiusY: 1,
-              force: 1,
-              id: 11,
-            };
-            await client.send("Input.dispatchTouchEvent", {
-              type: "touchStart",
-              touchPoints: [touchPoint],
-            });
-            if (durationMs) await page.waitForTimeout(durationMs);
-            await client.send("Input.dispatchTouchEvent", {
-              type: "touchEnd",
-              touchPoints: [],
-            });
-          } else {
-            await client.send("Input.dispatchMouseEvent", {
-              type: "mousePressed",
-              x: point.x,
-              y: point.y,
-              button: "left",
-              buttons: 1,
-              clickCount: 1,
-              pointerType: "pen",
-            });
-            if (durationMs) await page.waitForTimeout(durationMs);
-            await client.send("Input.dispatchMouseEvent", {
-              type: "mouseReleased",
-              x: point.x,
-              y: point.y,
-              button: "left",
-              buttons: 0,
-              clickCount: 1,
-              pointerType: "pen",
-            });
-          }
-        } finally {
-          await client.detach().catch(() => {});
+    }
+    if (type === "tap_until") {
+      const untilPath = String(action.until_path || action.untilPath || action.until_state_path || action.untilStatePath || action.until_window_path || action.untilWindowPath || action.until || "");
+      const hasUntilExpected = setupHasOwn(action, "until_expected_value")
+        || setupHasOwn(action, "untilExpectedValue")
+        || setupHasOwn(action, "until_expected")
+        || setupHasOwn(action, "untilExpected")
+        || setupHasOwn(action, "until_value")
+        || setupHasOwn(action, "untilValue")
+        || setupHasOwn(action, "expected_value")
+        || setupHasOwn(action, "expectedValue")
+        || setupHasOwn(action, "expected");
+      const untilExpected = setupHasOwn(action, "until_expected_value")
+        ? action.until_expected_value
+        : setupHasOwn(action, "untilExpectedValue")
+          ? action.untilExpectedValue
+          : setupHasOwn(action, "until_expected")
+            ? action.until_expected
+            : setupHasOwn(action, "untilExpected")
+              ? action.untilExpected
+              : setupHasOwn(action, "until_value")
+                ? action.until_value
+                : setupHasOwn(action, "untilValue")
+                  ? action.untilValue
+                  : setupHasOwn(action, "expected_value")
+                    ? action.expected_value
+                    : setupHasOwn(action, "expectedValue")
+                      ? action.expectedValue
+                      : action.expected;
+      if (!untilPath) return { ...base, reason: "missing_until_path" };
+      if (!hasUntilExpected) return { ...base, until_path: untilPath, reason: "missing_until_expected_value" };
+      const maxTaps = Math.min(100, Math.max(1, Math.floor(setupNumber(action.max_taps ?? action.maxTaps ?? action.tap_limit ?? action.tapLimit ?? action.max_calls ?? action.maxCalls ?? action.max_attempts ?? action.maxAttempts ?? action.attempts, 1) || 1)));
+      const intervalMs = Math.min(5000, Math.max(0, Math.floor(setupNumber(action.interval_ms ?? action.intervalMs ?? action.poll_ms ?? action.pollMs ?? action.tap_interval_ms ?? action.tapIntervalMs, 100) || 0)));
+      const scope = await setupActionScope(action, timeout);
+      if (!scope.ok) return setupScopeFailure(base, scope);
+      const prepared = await resolveSetupTapTarget(action, base, scope, timeout);
+      if (prepared.result) return prepared.result;
+      const startedAt = Date.now();
+      let tapCount = 0;
+      let lastPredicateResult = await setupReadWindowValue(scope.context, untilPath);
+      const targetEvidence = setupTapTargetEvidence(prepared.target);
+      if (lastPredicateResult.ok && setupValuesEqual(lastPredicateResult.value, untilExpected)) {
+        return {
+          ...base,
+          ...setupScopeEvidence(scope),
+          ok: true,
+          ...targetEvidence,
+          until_path: untilPath,
+          until_value: setupJsonValue(lastPredicateResult.value),
+          until_expected_value: setupJsonValue(untilExpected),
+          tap_count: tapCount,
+          max_taps: maxTaps,
+          max_calls: maxTaps,
+          interval_ms: intervalMs,
+          timeout_ms: timeout,
+        };
+      }
+      while (tapCount < maxTaps && Date.now() - startedAt <= timeout) {
+        await dispatchSetupTapPoint(prepared.target.point, prepared.target.pointerType, prepared.target.durationMs);
+        tapCount += 1;
+        lastPredicateResult = await setupReadWindowValue(scope.context, untilPath);
+        if (lastPredicateResult.ok && setupValuesEqual(lastPredicateResult.value, untilExpected)) {
+          return {
+            ...base,
+            ...setupScopeEvidence(scope),
+            ok: true,
+            ...targetEvidence,
+            until_path: untilPath,
+            until_value: setupJsonValue(lastPredicateResult.value),
+            until_expected_value: setupJsonValue(untilExpected),
+            tap_count: tapCount,
+            max_taps: maxTaps,
+            max_calls: maxTaps,
+            interval_ms: intervalMs,
+            timeout_ms: timeout,
+          };
         }
-      } else {
-        await page.mouse.click(point.x, point.y);
+        if (tapCount < maxTaps && intervalMs) await page.waitForTimeout(intervalMs);
       }
       return {
         ...base,
         ...setupScopeEvidence(scope),
-        ok: true,
-        count,
-        target_index: targetIndex,
-        coordinate_mode: hasTapPosition ? mode : undefined,
-        x: hasTapPosition ? fromX : undefined,
-        y: hasTapPosition ? fromY : undefined,
-        pointer_type: pointerType,
-        input_dispatch: pointerType === "touch" || pointerType === "pen" ? "cdp" : "playwright_mouse",
-        duration_ms: durationMs || undefined,
+        ...targetEvidence,
+        until_path: untilPath,
+        until_value: setupJsonValue(lastPredicateResult?.value),
+        until_expected_value: setupJsonValue(untilExpected),
+        tap_count: tapCount,
+        max_taps: maxTaps,
+        max_calls: maxTaps,
+        interval_ms: intervalMs,
+        timeout_ms: timeout,
+        reason: Date.now() - startedAt > timeout ? "timeout" : "until_condition_not_met",
+        missing_part: lastPredicateResult?.missing_part || undefined,
       };
     }
     if (type === "drag") {