@riddledc/riddle-proof 0.7.198 → 0.7.200

package/README.md

@@ -440,8 +440,10 @@ 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
+`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`, `elapsed_ms`, 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
@@ -540,11 +542,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,
+elapsed time, 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-FNVDZCVZ.js}

@@ -633,6 +633,9 @@ 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,
+    elapsed_ms: result.elapsed_ms ?? null,
     interval_ms: result.interval_ms ?? null,
     timeout_ms: result.timeout_ms ?? null,
     reason: result.reason ?? result.error ?? null
@@ -1273,6 +1276,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 +1327,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 +4567,9 @@ 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,
+      elapsed_ms: result.elapsed_ms ?? null,
       interval_ms: result.interval_ms ?? null,
       timeout_ms: result.timeout_ms ?? null,
       reason: result.reason || result.error || null,
@@ -6548,6 +6559,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,9 +6567,11 @@ 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)) {
+        const elapsedMs = Date.now() - startedAt;
         return {
           ...base,
           ...setupScopeEvidence(scope),
@@ -6569,15 +6583,24 @@ async function executeSetupAction(action, ordinal, viewport) {
           tap_count: tapCount,
           max_taps: maxTaps,
           max_calls: maxTaps,
+          tap_burst_size: tapBurstSize,
+          condition_check_count: conditionCheckCount,
+          elapsed_ms: elapsedMs,
           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)) {
+          const elapsedMs = Date.now() - startedAt;
           return {
             ...base,
             ...setupScopeEvidence(scope),
@@ -6589,12 +6612,16 @@ async function executeSetupAction(action, ordinal, viewport) {
             tap_count: tapCount,
             max_taps: maxTaps,
             max_calls: maxTaps,
+            tap_burst_size: tapBurstSize,
+            condition_check_count: conditionCheckCount,
+            elapsed_ms: elapsedMs,
             interval_ms: intervalMs,
             timeout_ms: timeout,
           };
         }
         if (tapCount < maxTaps && intervalMs) await page.waitForTimeout(intervalMs);
       }
+      const elapsedMs = Date.now() - startedAt;
       return {
         ...base,
         ...setupScopeEvidence(scope),
@@ -6605,9 +6632,12 @@ async function executeSetupAction(action, ordinal, viewport) {
         tap_count: tapCount,
         max_taps: maxTaps,
         max_calls: maxTaps,
+        tap_burst_size: tapBurstSize,
+        condition_check_count: conditionCheckCount,
+        elapsed_ms: elapsedMs,
         interval_ms: intervalMs,
         timeout_ms: timeout,
-        reason: Date.now() - startedAt > timeout ? "timeout" : "until_condition_not_met",
+        reason: elapsedMs > timeout ? "timeout" : "until_condition_not_met",
         missing_part: lastPredicateResult?.missing_part || undefined,
       };
     }

package/dist/cli.cjs

@@ -7590,6 +7590,9 @@ 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,
+    elapsed_ms: result.elapsed_ms ?? null,
     interval_ms: result.interval_ms ?? null,
     timeout_ms: result.timeout_ms ?? null,
     reason: result.reason ?? result.error ?? null
@@ -8230,6 +8233,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 +8284,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 +11508,9 @@ 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,
+      elapsed_ms: result.elapsed_ms ?? null,
       interval_ms: result.interval_ms ?? null,
       timeout_ms: result.timeout_ms ?? null,
       reason: result.reason || result.error || null,
@@ -13489,6 +13500,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,9 +13508,11 @@ 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)) {
+        const elapsedMs = Date.now() - startedAt;
         return {
           ...base,
           ...setupScopeEvidence(scope),
@@ -13510,15 +13524,24 @@ async function executeSetupAction(action, ordinal, viewport) {
           tap_count: tapCount,
           max_taps: maxTaps,
           max_calls: maxTaps,
+          tap_burst_size: tapBurstSize,
+          condition_check_count: conditionCheckCount,
+          elapsed_ms: elapsedMs,
           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)) {
+          const elapsedMs = Date.now() - startedAt;
           return {
             ...base,
             ...setupScopeEvidence(scope),
@@ -13530,12 +13553,16 @@ async function executeSetupAction(action, ordinal, viewport) {
             tap_count: tapCount,
             max_taps: maxTaps,
             max_calls: maxTaps,
+            tap_burst_size: tapBurstSize,
+            condition_check_count: conditionCheckCount,
+            elapsed_ms: elapsedMs,
             interval_ms: intervalMs,
             timeout_ms: timeout,
           };
         }
         if (tapCount < maxTaps && intervalMs) await page.waitForTimeout(intervalMs);
       }
+      const elapsedMs = Date.now() - startedAt;
       return {
         ...base,
         ...setupScopeEvidence(scope),
@@ -13546,9 +13573,12 @@ async function executeSetupAction(action, ordinal, viewport) {
         tap_count: tapCount,
         max_taps: maxTaps,
         max_calls: maxTaps,
+        tap_burst_size: tapBurstSize,
+        condition_check_count: conditionCheckCount,
+        elapsed_ms: elapsedMs,
         interval_ms: intervalMs,
         timeout_ms: timeout,
-        reason: Date.now() - startedAt > timeout ? "timeout" : "until_condition_not_met",
+        reason: elapsedMs > timeout ? "timeout" : "until_condition_not_met",
         missing_part: lastPredicateResult?.missing_part || undefined,
       };
     }
@@ -18052,11 +18082,17 @@ 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 elapsedMs3 = cliFiniteNumber(receipt.elapsed_ms);
     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)`;
+    const elapsedText = elapsedMs3 === void 0 ? "" : `, elapsed ${elapsedMs3}ms`;
+    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}${elapsedText}${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-FNVDZCVZ.js";
 import {
   createRiddleApiClient,
   isTerminalRiddleJobStatus,
@@ -1919,11 +1919,17 @@ 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 elapsedMs = cliFiniteNumber(receipt.elapsed_ms);
     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)`;
+    const elapsedText = elapsedMs === void 0 ? "" : `, elapsed ${elapsedMs}ms`;
+    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}${elapsedText}${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,9 @@ 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,
+    elapsed_ms: result.elapsed_ms ?? null,
     interval_ms: result.interval_ms ?? null,
     timeout_ms: result.timeout_ms ?? null,
     reason: result.reason ?? result.error ?? null
@@ -10006,6 +10009,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 +10060,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 +13300,9 @@ 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,
+      elapsed_ms: result.elapsed_ms ?? null,
       interval_ms: result.interval_ms ?? null,
       timeout_ms: result.timeout_ms ?? null,
       reason: result.reason || result.error || null,
@@ -15281,6 +15292,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,9 +15300,11 @@ 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)) {
+        const elapsedMs = Date.now() - startedAt;
         return {
           ...base,
           ...setupScopeEvidence(scope),
@@ -15302,15 +15316,24 @@ async function executeSetupAction(action, ordinal, viewport) {
           tap_count: tapCount,
           max_taps: maxTaps,
           max_calls: maxTaps,
+          tap_burst_size: tapBurstSize,
+          condition_check_count: conditionCheckCount,
+          elapsed_ms: elapsedMs,
           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)) {
+          const elapsedMs = Date.now() - startedAt;
           return {
             ...base,
             ...setupScopeEvidence(scope),
@@ -15322,12 +15345,16 @@ async function executeSetupAction(action, ordinal, viewport) {
             tap_count: tapCount,
             max_taps: maxTaps,
             max_calls: maxTaps,
+            tap_burst_size: tapBurstSize,
+            condition_check_count: conditionCheckCount,
+            elapsed_ms: elapsedMs,
             interval_ms: intervalMs,
             timeout_ms: timeout,
           };
         }
         if (tapCount < maxTaps && intervalMs) await page.waitForTimeout(intervalMs);
       }
+      const elapsedMs = Date.now() - startedAt;
       return {
         ...base,
         ...setupScopeEvidence(scope),
@@ -15338,9 +15365,12 @@ async function executeSetupAction(action, ordinal, viewport) {
         tap_count: tapCount,
         max_taps: maxTaps,
         max_calls: maxTaps,
+        tap_burst_size: tapBurstSize,
+        condition_check_count: conditionCheckCount,
+        elapsed_ms: elapsedMs,
         interval_ms: intervalMs,
         timeout_ms: timeout,
-        reason: Date.now() - startedAt > timeout ? "timeout" : "until_condition_not_met",
+        reason: elapsedMs > timeout ? "timeout" : "until_condition_not_met",
         missing_part: lastPredicateResult?.missing_part || undefined,
       };
     }

package/dist/index.js

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

package/dist/profile.cjs

@@ -680,6 +680,9 @@ 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,
+    elapsed_ms: result.elapsed_ms ?? null,
     interval_ms: result.interval_ms ?? null,
     timeout_ms: result.timeout_ms ?? null,
     reason: result.reason ?? result.error ?? null
@@ -1320,6 +1323,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 +1374,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 +4614,9 @@ 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,
+      elapsed_ms: result.elapsed_ms ?? null,
       interval_ms: result.interval_ms ?? null,
       timeout_ms: result.timeout_ms ?? null,
       reason: result.reason || result.error || null,
@@ -6595,6 +6606,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,9 +6614,11 @@ 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)) {
+        const elapsedMs = Date.now() - startedAt;
         return {
           ...base,
           ...setupScopeEvidence(scope),
@@ -6616,15 +6630,24 @@ async function executeSetupAction(action, ordinal, viewport) {
           tap_count: tapCount,
           max_taps: maxTaps,
           max_calls: maxTaps,
+          tap_burst_size: tapBurstSize,
+          condition_check_count: conditionCheckCount,
+          elapsed_ms: elapsedMs,
           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)) {
+          const elapsedMs = Date.now() - startedAt;
           return {
             ...base,
             ...setupScopeEvidence(scope),
@@ -6636,12 +6659,16 @@ async function executeSetupAction(action, ordinal, viewport) {
             tap_count: tapCount,
             max_taps: maxTaps,
             max_calls: maxTaps,
+            tap_burst_size: tapBurstSize,
+            condition_check_count: conditionCheckCount,
+            elapsed_ms: elapsedMs,
             interval_ms: intervalMs,
             timeout_ms: timeout,
           };
         }
         if (tapCount < maxTaps && intervalMs) await page.waitForTimeout(intervalMs);
       }
+      const elapsedMs = Date.now() - startedAt;
       return {
         ...base,
         ...setupScopeEvidence(scope),
@@ -6652,9 +6679,12 @@ async function executeSetupAction(action, ordinal, viewport) {
         tap_count: tapCount,
         max_taps: maxTaps,
         max_calls: maxTaps,
+        tap_burst_size: tapBurstSize,
+        condition_check_count: conditionCheckCount,
+        elapsed_ms: elapsedMs,
         interval_ms: intervalMs,
         timeout_ms: timeout,
-        reason: Date.now() - startedAt > timeout ? "timeout" : "until_condition_not_met",
+        reason: elapsedMs > timeout ? "timeout" : "until_condition_not_met",
         missing_part: lastPredicateResult?.missing_part || undefined,
       };
     }

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-FNVDZCVZ.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.200",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",