@riddledc/riddle-proof 0.7.198 → 0.7.199

package/README.md

@@ -440,10 +440,11 @@ 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.
+`interval_ms`. Set `tap_burst_size` from 1 to 100 when gameplay needs several
+fast taps before the next predicate check. The action stops early when the
+predicate matches and records one compact receipt with `tap_count`,
+`condition_check_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`
@@ -540,11 +541,11 @@ 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. `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.
+one compact receipt with total taps, optional burst size, predicate-check count,
+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.
 
 `target.timeout_sec` is optional. Use it for known-heavy profile targets so the
 profile carries its own hosted Riddle worker budget; an explicit CLI `--timeout`

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

@@ -633,6 +633,8 @@ function profileSetupTapUntilReceipts(results) {
     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
@@ -1273,6 +1275,10 @@ function normalizeSetupAction(input, index) {
   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" || 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.`);
@@ -1320,6 +1326,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,
@@ -4559,6 +4566,8 @@ function profileSetupTapUntilReceipts(results) {
       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,
@@ -6548,6 +6557,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       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);
@@ -6555,6 +6565,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       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)) {
@@ -6569,14 +6580,21 @@ async function executeSetupAction(action, ordinal, viewport) {
           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) {
-        await dispatchSetupTapPoint(prepared.target.point, prepared.target.pointerType, prepared.target.durationMs);
-        tapCount += 1;
+        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);
+        }
         lastPredicateResult = await setupReadWindowValue(scope.context, untilPath);
+        conditionCheckCount += 1;
         if (lastPredicateResult.ok && setupValuesEqual(lastPredicateResult.value, untilExpected)) {
           return {
             ...base,
@@ -6589,6 +6607,8 @@ async function executeSetupAction(action, ordinal, viewport) {
             tap_count: tapCount,
             max_taps: maxTaps,
             max_calls: maxTaps,
+            tap_burst_size: tapBurstSize,
+            condition_check_count: conditionCheckCount,
             interval_ms: intervalMs,
             timeout_ms: timeout,
           };
@@ -6605,6 +6625,8 @@ async function executeSetupAction(action, ordinal, viewport) {
         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",

package/dist/cli.cjs

@@ -7590,6 +7590,8 @@ function profileSetupTapUntilReceipts(results) {
     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
@@ -8230,6 +8232,10 @@ function normalizeSetupAction(input, index) {
   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" || 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.`);
@@ -8277,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,
@@ -11500,6 +11507,8 @@ function profileSetupTapUntilReceipts(results) {
       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,
@@ -13489,6 +13498,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       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);
@@ -13496,6 +13506,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       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)) {
@@ -13510,14 +13521,21 @@ async function executeSetupAction(action, ordinal, viewport) {
           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) {
-        await dispatchSetupTapPoint(prepared.target.point, prepared.target.pointerType, prepared.target.durationMs);
-        tapCount += 1;
+        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);
+        }
         lastPredicateResult = await setupReadWindowValue(scope.context, untilPath);
+        conditionCheckCount += 1;
         if (lastPredicateResult.ok && setupValuesEqual(lastPredicateResult.value, untilExpected)) {
           return {
             ...base,
@@ -13530,6 +13548,8 @@ async function executeSetupAction(action, ordinal, viewport) {
             tap_count: tapCount,
             max_taps: maxTaps,
             max_calls: maxTaps,
+            tap_burst_size: tapBurstSize,
+            condition_check_count: conditionCheckCount,
             interval_ms: intervalMs,
             timeout_ms: timeout,
           };
@@ -13546,6 +13566,8 @@ async function executeSetupAction(action, ordinal, viewport) {
         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",
@@ -18052,11 +18074,15 @@ function profileSetupSummaryMarkdown(result) {
     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)`;
-    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}${actual === void 0 ? "" : `, observed ${markdownInlineCode(actual, 80)}`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
+    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) => {

package/dist/cli.js

@@ -13,7 +13,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-DL6UB4N6.js";
+} from "./chunk-EXFYPLP2.js";
 import {
   createRiddleApiClient,
   isTerminalRiddleJobStatus,
@@ -1919,11 +1919,15 @@ function profileSetupSummaryMarkdown(result) {
     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)`;
-    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}${actual === void 0 ? "" : `, observed ${markdownInlineCode(actual, 80)}`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
+    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) => {

package/dist/index.cjs

@@ -9366,6 +9366,8 @@ function profileSetupTapUntilReceipts(results) {
     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
@@ -10006,6 +10008,10 @@ function normalizeSetupAction(input, index) {
   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" ? numberValue3(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 = numberValue3(valueFromOwn(input, "interval_ms", "intervalMs", "poll_ms", "pollMs", "call_interval_ms", "callIntervalMs"));
   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.`);
@@ -10053,6 +10059,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,
@@ -13292,6 +13299,8 @@ function profileSetupTapUntilReceipts(results) {
       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,
@@ -15281,6 +15290,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       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);
@@ -15288,6 +15298,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       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)) {
@@ -15302,14 +15313,21 @@ async function executeSetupAction(action, ordinal, viewport) {
           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) {
-        await dispatchSetupTapPoint(prepared.target.point, prepared.target.pointerType, prepared.target.durationMs);
-        tapCount += 1;
+        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);
+        }
         lastPredicateResult = await setupReadWindowValue(scope.context, untilPath);
+        conditionCheckCount += 1;
         if (lastPredicateResult.ok && setupValuesEqual(lastPredicateResult.value, untilExpected)) {
           return {
             ...base,
@@ -15322,6 +15340,8 @@ async function executeSetupAction(action, ordinal, viewport) {
             tap_count: tapCount,
             max_taps: maxTaps,
             max_calls: maxTaps,
+            tap_burst_size: tapBurstSize,
+            condition_check_count: conditionCheckCount,
             interval_ms: intervalMs,
             timeout_ms: timeout,
           };
@@ -15338,6 +15358,8 @@ async function executeSetupAction(action, ordinal, viewport) {
         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",

package/dist/index.js

@@ -62,7 +62,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-DL6UB4N6.js";
+} from "./chunk-EXFYPLP2.js";
 import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,

package/dist/profile.cjs

@@ -680,6 +680,8 @@ function profileSetupTapUntilReceipts(results) {
     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
@@ -1320,6 +1322,10 @@ function normalizeSetupAction(input, index) {
   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" || 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.`);
@@ -1367,6 +1373,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,
@@ -4606,6 +4613,8 @@ function profileSetupTapUntilReceipts(results) {
       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,
@@ -6595,6 +6604,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       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);
@@ -6602,6 +6612,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       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)) {
@@ -6616,14 +6627,21 @@ async function executeSetupAction(action, ordinal, viewport) {
           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) {
-        await dispatchSetupTapPoint(prepared.target.point, prepared.target.pointerType, prepared.target.durationMs);
-        tapCount += 1;
+        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);
+        }
         lastPredicateResult = await setupReadWindowValue(scope.context, untilPath);
+        conditionCheckCount += 1;
         if (lastPredicateResult.ok && setupValuesEqual(lastPredicateResult.value, untilExpected)) {
           return {
             ...base,
@@ -6636,6 +6654,8 @@ async function executeSetupAction(action, ordinal, viewport) {
             tap_count: tapCount,
             max_taps: maxTaps,
             max_calls: maxTaps,
+            tap_burst_size: tapBurstSize,
+            condition_check_count: conditionCheckCount,
             interval_ms: intervalMs,
             timeout_ms: timeout,
           };
@@ -6652,6 +6672,8 @@ async function executeSetupAction(action, ordinal, viewport) {
         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",

package/dist/profile.d.cts

@@ -146,6 +146,7 @@ interface RiddleProofProfileSetupAction {
     until_path?: string;
     until_expected_value?: JsonValue;
     max_calls?: number;
+    tap_burst_size?: number;
     interval_ms?: number;
     expected_value?: JsonValue;
     min_value?: number;

package/dist/profile.d.ts

@@ -146,6 +146,7 @@ interface RiddleProofProfileSetupAction {
     until_path?: string;
     until_expected_value?: JsonValue;
     max_calls?: number;
+    tap_burst_size?: number;
     interval_ms?: number;
     expected_value?: JsonValue;
     min_value?: number;

package/dist/profile.js

@@ -23,7 +23,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-DL6UB4N6.js";
+} from "./chunk-EXFYPLP2.js";
 export {
   RIDDLE_PROOF_PROFILE_CHECK_TYPES,
   RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riddledc/riddle-proof",
-  "version": "0.7.198",
+  "version": "0.7.199",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",