@riddledc/riddle-proof 0.7.197 → 0.7.199

package/dist/cli.cjs

@@ -7002,6 +7002,7 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
 var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "click",
   "tap",
+  "tap_until",
   "drag",
   "press",
   "key_down",
@@ -7572,6 +7573,30 @@ 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,
+    tap_burst_size: result.tap_burst_size ?? null,
+    condition_check_count: result.condition_check_count ?? 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),
@@ -7747,6 +7772,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);
@@ -7819,6 +7847,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,
@@ -7880,7 +7912,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;
   }
@@ -7962,8 +7994,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";
@@ -8042,11 +8074,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);
@@ -8071,18 +8103,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.`);
       }
     }
   }
@@ -8188,7 +8220,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.`);
     }
@@ -8196,12 +8228,16 @@ 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 tapBurstSize = type === "tap_until" ? numberValue(valueFromOwn(input, "tap_burst_size", "tapBurstSize", "burst_size", "burstSize", "check_every_taps", "checkEveryTaps", "predicate_interval_taps", "predicateIntervalTaps")) : void 0;
+  if (type === "tap_until" && tapBurstSize !== void 0 && (!Number.isInteger(tapBurstSize) || tapBurstSize < 1 || tapBurstSize > 100)) {
+    throw new Error(`target.setup_actions[${index}].tap_burst_size 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);
@@ -8247,6 +8283,7 @@ function normalizeSetupAction(input, index) {
     until_path: untilPath,
     until_expected_value: hasUntilExpectedValue ? toJsonValue(valueFromOwn(input, "until_expected_value", "untilExpectedValue", "until_expected", "untilExpected", "until_value", "untilValue", "expected_value", "expectedValue", "expected")) : void 0,
     max_calls: maxCalls,
+    tap_burst_size: tapBurstSize,
     interval_ms: intervalMs,
     expected_value: hasExpectedValue ? toJsonValue(rawExpectedValue) : void 0,
     min_value: minValue,
@@ -11451,6 +11488,32 @@ 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,
+      tap_burst_size: result.tap_burst_size ?? null,
+      condition_check_count: result.condition_check_count ?? 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)))
@@ -11653,6 +11716,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);
@@ -11735,6 +11803,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,
@@ -12681,6 +12753,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);
 }
@@ -13283,91 +13457,121 @@ 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 tapBurstSize = Math.min(maxTaps, Math.min(100, Math.max(1, Math.floor(setupNumber(action.tap_burst_size ?? action.tapBurstSize ?? action.burst_size ?? action.burstSize ?? action.check_every_taps ?? action.checkEveryTaps ?? action.predicate_interval_taps ?? action.predicateIntervalTaps, 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 conditionCheckCount = 1;
+      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,
+          tap_burst_size: tapBurstSize,
+          condition_check_count: conditionCheckCount,
+          interval_ms: intervalMs,
+          timeout_ms: timeout,
+        };
+      }
+      while (tapCount < maxTaps && Date.now() - startedAt <= timeout) {
+        const burstCount = Math.min(tapBurstSize, maxTaps - tapCount);
+        for (let burstIndex = 0; burstIndex < burstCount && Date.now() - startedAt <= timeout; burstIndex += 1) {
+          await dispatchSetupTapPoint(prepared.target.point, prepared.target.pointerType, prepared.target.durationMs);
+          tapCount += 1;
+          if (tapCount < maxTaps && burstIndex < burstCount - 1 && intervalMs) await page.waitForTimeout(intervalMs);
         }
-      } else {
-        await page.mouse.click(point.x, point.y);
+        lastPredicateResult = await setupReadWindowValue(scope.context, untilPath);
+        conditionCheckCount += 1;
+        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,
+            tap_burst_size: tapBurstSize,
+            condition_check_count: conditionCheckCount,
+            interval_ms: intervalMs,
+            timeout_ms: timeout,
+          };
+        }
+        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,
+        tap_burst_size: tapBurstSize,
+        condition_check_count: conditionCheckCount,
+        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") {
@@ -16799,10 +17003,11 @@ function profilePackReceiptStatus(result, metadata, receipt) {
     clickFallbackTapKeys.add(`${ordinal === void 0 ? `idx:${index}` : `ord:${ordinal}`}:${frameSelector}:${selector}`);
   });
   const clickFallbackTapCount = clickFallbackTapKeys.size;
-  const visibleUiActionCount = clickCount + profileSetupReceiptTotal(setupViewports, "tap");
+  const tapUntilCount = profileSetupReceiptTotal(setupViewports, "tap_until");
+  const visibleUiActionCount = clickCount + profileSetupReceiptTotal(setupViewports, "tap") + tapUntilCount;
   const setupFailureCount = profileSetupFailureCount(setupViewports);
   const setupObstructionCount = profileSetupObstructionCount(setupViewports);
-  const inputDispatchCount = profileSetupReceiptTotal(setupViewports, "drag") + profileSetupReceiptTotal(setupViewports, "tap") + profileSetupReceiptTotal(setupViewports, "press") + profileSetupReceiptTotal(setupViewports, "keyboard_sequence");
+  const inputDispatchCount = profileSetupReceiptTotal(setupViewports, "drag") + profileSetupReceiptTotal(setupViewports, "tap") + tapUntilCount + profileSetupReceiptTotal(setupViewports, "press") + profileSetupReceiptTotal(setupViewports, "keyboard_sequence");
   const canvasReceipts = setupViewports.flatMap((viewport) => setupReceiptArray(viewport, "canvas_signature"));
   const hasCanvasChange = canvasReceipts.some((item) => item.ok !== false && item.changed === true);
   const canvasSignatureHashes = canvasReceipts.filter((item) => item.ok !== false).map((item) => cliString(item.hash)).filter(Boolean);
@@ -16869,6 +17074,13 @@ function profilePackReceiptStatus(result, metadata, receipt) {
       "click fallback tap evidence missing"
     );
   }
+  if (text.includes("tap_until") || text.includes("tap until") || text.includes("tap-until")) {
+    return profileReceiptSignalStatus(
+      tapUntilCount > 0,
+      `tap_until receipt present (${tapUntilCount})`,
+      "tap_until receipt missing"
+    );
+  }
   if (text.includes("active") && (text.includes("route-local") || text.includes("route local")) && (text.includes("proof helper") || text.includes("proof api") || text.includes("proof state"))) {
     return profileReceiptSignalStatus(
       hasActiveRouteLocalProofReceipt,
@@ -17304,6 +17516,7 @@ function setupNaturalInputSummaryMarkdown(viewports) {
     const inputReceipts = [
       ...setupReceiptArray(viewport, "drag").map((receipt) => ({ kind: "drag", receipt })),
       ...setupReceiptArray(viewport, "tap").map((receipt) => ({ kind: "tap", receipt })),
+      ...setupReceiptArray(viewport, "tap_until").map((receipt) => ({ kind: "tap_until", receipt })),
       ...setupReceiptArray(viewport, "press").map((receipt) => ({ kind: "press", receipt }))
     ].filter(({ receipt }) => receipt.ok !== false);
     if (!inputReceipts.length) continue;
@@ -17698,6 +17911,8 @@ function profileSetupSummaryMarkdown(result) {
   const rangeValueTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.set_range_value_total) || 0), 0);
   const dragTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.drag_total) || 0), 0);
   const tapTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.tap_total) || 0), 0);
+  const tapUntilTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.tap_until_total) || 0), 0);
+  const tapUntilTapTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.tap_until_tap_total) || 0), 0);
   const keyboardTotal = viewports.reduce((sum, viewport) => {
     const total = cliFiniteNumber(viewport.keyboard_total);
     return sum + (total === void 0 ? cliFiniteNumber(viewport.press_total) || 0 : total);
@@ -17737,6 +17952,9 @@ function profileSetupSummaryMarkdown(result) {
   if (tapTotal) {
     lines.push(`- tap: ${tapTotal} action(s)`);
   }
+  if (tapUntilTotal) {
+    lines.push(`- tap_until: ${tapUntilTotal} action(s), tap_count total ${tapUntilTapTotal}`);
+  }
   if (keyboardTotal) {
     lines.push(`- keyboard: ${keyboardTotal} action(s)`);
   }
@@ -17764,10 +17982,12 @@ function profileSetupSummaryMarkdown(result) {
     const rangeValueActions = cliFiniteNumber(viewport.set_range_value_total) || 0;
     const dragActions = cliFiniteNumber(viewport.drag_total) || 0;
     const tapActions = cliFiniteNumber(viewport.tap_total) || 0;
+    const tapUntilActions = cliFiniteNumber(viewport.tap_until_total) || 0;
+    const tapUntilTaps = cliFiniteNumber(viewport.tap_until_tap_total) || 0;
     const keyboardActions = cliFiniteNumber(viewport.keyboard_total) ?? cliFiniteNumber(viewport.press_total) ?? 0;
     const canvasSignatureActions = cliFiniteNumber(viewport.canvas_signature_total) || 0;
     const observedPath = cliString(viewport.observed_path);
-    lines.push(`- ${name}: ${ok}, ${resultCount} result(s), ${screenshotCount} setup screenshot(s), ${clicked} click(s)${clickSequenceCount ? `, ${clickSequenceCount} click sequence(s)` : ""}${clickCountActions ? `, ${clickCountActions} click_count action(s)` : ""}${rangeValueActions ? `, ${rangeValueActions} set_range_value action(s)` : ""}${dragActions ? `, ${dragActions} drag action(s)` : ""}${tapActions ? `, ${tapActions} tap action(s)` : ""}${keyboardActions ? `, ${keyboardActions} keyboard action(s)` : ""}${canvasSignatureActions ? `, ${canvasSignatureActions} canvas_signature action(s)` : ""}${deterministicRuntimeActions ? `, ${deterministicRuntimeActions} deterministic_runtime action(s)` : ""}${windowCallActions ? `, ${windowCallActions} window_call action(s), ${windowCallStored} stored return(s), ${windowCallCaptured} captured return(s)` : ""}${windowEvalActions ? `, ${windowEvalActions} window_eval action(s), ${windowEvalStored} stored return(s), ${windowEvalCaptured} captured return(s)` : ""}${windowCallUntilActions ? `, ${windowCallUntilActions} window_call_until action(s), ${windowCallUntilCalls} call(s)` : ""}${observedPath ? `, path ${observedPath}` : ""}`);
+    lines.push(`- ${name}: ${ok}, ${resultCount} result(s), ${screenshotCount} setup screenshot(s), ${clicked} click(s)${clickSequenceCount ? `, ${clickSequenceCount} click sequence(s)` : ""}${clickCountActions ? `, ${clickCountActions} click_count action(s)` : ""}${rangeValueActions ? `, ${rangeValueActions} set_range_value action(s)` : ""}${dragActions ? `, ${dragActions} drag action(s)` : ""}${tapActions ? `, ${tapActions} tap action(s)` : ""}${tapUntilActions ? `, ${tapUntilActions} tap_until action(s), ${tapUntilTaps} tap(s)` : ""}${keyboardActions ? `, ${keyboardActions} keyboard action(s)` : ""}${canvasSignatureActions ? `, ${canvasSignatureActions} canvas_signature action(s)` : ""}${deterministicRuntimeActions ? `, ${deterministicRuntimeActions} deterministic_runtime action(s)` : ""}${windowCallActions ? `, ${windowCallActions} window_call action(s), ${windowCallStored} stored return(s), ${windowCallCaptured} captured return(s)` : ""}${windowEvalActions ? `, ${windowEvalActions} window_eval action(s), ${windowEvalStored} stored return(s), ${windowEvalCaptured} captured return(s)` : ""}${windowCallUntilActions ? `, ${windowCallUntilActions} window_call_until action(s), ${windowCallUntilCalls} call(s)` : ""}${observedPath ? `, path ${observedPath}` : ""}`);
   }
   const clickSequenceGroups = viewports.map((viewport) => {
     const name = cliString(viewport.name) || "viewport";
@@ -17834,6 +18054,37 @@ function profileSetupSummaryMarkdown(result) {
     lines.push(`- ${name} tap: ${ok}, ${markdownInlineCode(selector)}${pointerType ? ` ${markdownInlineCode(pointerType)}` : ""}${inputDispatch ? ` via ${markdownInlineCode(inputDispatch)}` : ""}${coordinateText}${durationMs === void 0 ? "" : `, duration ${durationMs}ms`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
   }
   if (tapDetails.length > sampledTapDetails.length) lines.push(`- ${tapDetails.length - sampledTapDetails.length} additional tap receipt(s) omitted.`);
+  const tapUntilGroups = viewports.map((viewport) => {
+    const name = cliString(viewport.name) || "viewport";
+    const receipts = Array.isArray(viewport.tap_until) ? viewport.tap_until.map(cliRecord).filter((item) => Boolean(item)) : [];
+    return receipts.map((receipt) => ({ name, receipt }));
+  });
+  const tapUntilDetails = tapUntilGroups.flat();
+  const sampledTapUntilDetails = balancedSetupReceiptDetails(tapUntilGroups, 12);
+  for (const { name, receipt } of sampledTapUntilDetails) {
+    const selector = cliString(receipt.selector) || "target";
+    const pointerType = cliString(receipt.pointer_type);
+    const inputDispatch = cliString(receipt.input_dispatch);
+    const coordinateMode = cliString(receipt.coordinate_mode);
+    const x = cliValueLabel(receipt.x);
+    const y = cliValueLabel(receipt.y);
+    const durationMs = cliFiniteNumber(receipt.duration_ms);
+    const untilPath = cliString(receipt.until_path) || "until_path";
+    const expected = cliValueLabel(receipt.until_expected_value);
+    const actual = cliValueLabel(receipt.until_value);
+    const tapCount = cliFiniteNumber(receipt.tap_count);
+    const maxTaps = cliFiniteNumber(receipt.max_taps) ?? cliFiniteNumber(receipt.max_calls);
+    const tapBurstSize = cliFiniteNumber(receipt.tap_burst_size);
+    const conditionCheckCount = cliFiniteNumber(receipt.condition_check_count);
+    const ok = receipt.ok === false ? "failed" : "ok";
+    const reason = cliString(receipt.reason);
+    const coordinateText = x && y ? `, ${coordinateMode ? `${coordinateMode} ` : ""}${markdownInlineCode(`${x},${y}`)}` : "";
+    const tapText = tapCount === void 0 ? "" : ` in ${tapCount}${maxTaps === void 0 ? "" : `/${maxTaps}`} tap(s)`;
+    const burstText = tapBurstSize === void 0 || tapBurstSize <= 1 ? "" : `, burst ${tapBurstSize}`;
+    const conditionCheckText = conditionCheckCount === void 0 ? "" : `, ${conditionCheckCount} check(s)`;
+    lines.push(`- ${name} tap_until: ${ok}, ${markdownInlineCode(selector)}${pointerType ? ` ${markdownInlineCode(pointerType)}` : ""}${inputDispatch ? ` via ${markdownInlineCode(inputDispatch)}` : ""}${coordinateText}${durationMs === void 0 ? "" : `, duration ${durationMs}ms`} until ${markdownInlineCode(untilPath)}${expected === void 0 ? "" : ` == ${markdownInlineCode(expected, 80)}`}${tapText}${burstText}${conditionCheckText}${actual === void 0 ? "" : `, observed ${markdownInlineCode(actual, 80)}`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
+  }
+  if (tapUntilDetails.length > sampledTapUntilDetails.length) lines.push(`- ${tapUntilDetails.length - sampledTapUntilDetails.length} additional tap_until receipt(s) omitted.`);
   const keyboardGroups = viewports.map((viewport) => {
     const name = cliString(viewport.name) || "viewport";
     const rawReceipts = Array.isArray(viewport.keyboard) ? viewport.keyboard : viewport.press;