@riddledc/riddle-proof 0.7.200 → 0.7.201

package/README.md

@@ -441,11 +441,12 @@ 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`. 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.
+fast taps before the next predicate check, and `settle_ms` when the app needs a
+short post-burst frame/update delay before the predicate is trustworthy. The
+action stops early when the predicate matches and records one compact receipt
+with `tap_count`, `condition_check_count`, `settle_ms`, `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
 accepts aliases such as `set-slider-value`, requires `selector` plus `value`,
 uses the native input value setter, dispatches bubbling `input` and `change`
@@ -543,10 +544,11 @@ 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, 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.
+optional settle time, 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-FNVDZCVZ.js → chunk-OUZKZ5U4.js}

@@ -635,6 +635,7 @@ function profileSetupTapUntilReceipts(results) {
     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,
+    settle_ms: result.settle_ms ?? null,
     elapsed_ms: result.elapsed_ms ?? null,
     interval_ms: result.interval_ms ?? null,
     timeout_ms: result.timeout_ms ?? null,
@@ -1280,6 +1281,10 @@ function normalizeSetupAction(input, index) {
   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 settleMs = type === "tap_until" ? numberValue(valueFromOwn(input, "settle_ms", "settleMs", "predicate_settle_ms", "predicateSettleMs", "post_burst_wait_ms", "postBurstWaitMs", "after_burst_ms", "afterBurstMs", "settle_after_tap_ms", "settleAfterTapMs")) : void 0;
+  if (type === "tap_until" && settleMs !== void 0 && (!Number.isInteger(settleMs) || settleMs < 0 || settleMs > 1e4)) {
+    throw new Error(`target.setup_actions[${index}].settle_ms must be an integer from 0 to 10000.`);
+  }
   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.`);
@@ -1328,6 +1333,7 @@ function normalizeSetupAction(input, index) {
     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,
+    settle_ms: settleMs,
     interval_ms: intervalMs,
     expected_value: hasExpectedValue ? toJsonValue(rawExpectedValue) : void 0,
     min_value: minValue,
@@ -4569,6 +4575,7 @@ function profileSetupTapUntilReceipts(results) {
       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,
+      settle_ms: result.settle_ms ?? null,
       elapsed_ms: result.elapsed_ms ?? null,
       interval_ms: result.interval_ms ?? null,
       timeout_ms: result.timeout_ms ?? null,
@@ -6560,6 +6567,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       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 settleMs = Math.min(10000, Math.max(0, Math.floor(setupNumber(action.settle_ms ?? action.settleMs ?? action.predicate_settle_ms ?? action.predicateSettleMs ?? action.post_burst_wait_ms ?? action.postBurstWaitMs ?? action.after_burst_ms ?? action.afterBurstMs ?? action.settle_after_tap_ms ?? action.settleAfterTapMs, 0) || 0)));
       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);
@@ -6585,6 +6593,7 @@ async function executeSetupAction(action, ordinal, viewport) {
           max_calls: maxTaps,
           tap_burst_size: tapBurstSize,
           condition_check_count: conditionCheckCount,
+          settle_ms: settleMs,
           elapsed_ms: elapsedMs,
           interval_ms: intervalMs,
           timeout_ms: timeout,
@@ -6597,6 +6606,7 @@ async function executeSetupAction(action, ordinal, viewport) {
           tapCount += 1;
           if (tapCount < maxTaps && burstIndex < burstCount - 1 && intervalMs) await page.waitForTimeout(intervalMs);
         }
+        if (settleMs) await page.waitForTimeout(settleMs);
         lastPredicateResult = await setupReadWindowValue(scope.context, untilPath);
         conditionCheckCount += 1;
         if (lastPredicateResult.ok && setupValuesEqual(lastPredicateResult.value, untilExpected)) {
@@ -6614,6 +6624,7 @@ async function executeSetupAction(action, ordinal, viewport) {
             max_calls: maxTaps,
             tap_burst_size: tapBurstSize,
             condition_check_count: conditionCheckCount,
+            settle_ms: settleMs,
             elapsed_ms: elapsedMs,
             interval_ms: intervalMs,
             timeout_ms: timeout,
@@ -6634,6 +6645,7 @@ async function executeSetupAction(action, ordinal, viewport) {
         max_calls: maxTaps,
         tap_burst_size: tapBurstSize,
         condition_check_count: conditionCheckCount,
+        settle_ms: settleMs,
         elapsed_ms: elapsedMs,
         interval_ms: intervalMs,
         timeout_ms: timeout,

package/dist/cli.cjs

@@ -7592,6 +7592,7 @@ function profileSetupTapUntilReceipts(results) {
     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,
+    settle_ms: result.settle_ms ?? null,
     elapsed_ms: result.elapsed_ms ?? null,
     interval_ms: result.interval_ms ?? null,
     timeout_ms: result.timeout_ms ?? null,
@@ -8237,6 +8238,10 @@ function normalizeSetupAction(input, index) {
   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 settleMs = type === "tap_until" ? numberValue(valueFromOwn(input, "settle_ms", "settleMs", "predicate_settle_ms", "predicateSettleMs", "post_burst_wait_ms", "postBurstWaitMs", "after_burst_ms", "afterBurstMs", "settle_after_tap_ms", "settleAfterTapMs")) : void 0;
+  if (type === "tap_until" && settleMs !== void 0 && (!Number.isInteger(settleMs) || settleMs < 0 || settleMs > 1e4)) {
+    throw new Error(`target.setup_actions[${index}].settle_ms must be an integer from 0 to 10000.`);
+  }
   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.`);
@@ -8285,6 +8290,7 @@ function normalizeSetupAction(input, index) {
     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,
+    settle_ms: settleMs,
     interval_ms: intervalMs,
     expected_value: hasExpectedValue ? toJsonValue(rawExpectedValue) : void 0,
     min_value: minValue,
@@ -11510,6 +11516,7 @@ function profileSetupTapUntilReceipts(results) {
       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,
+      settle_ms: result.settle_ms ?? null,
       elapsed_ms: result.elapsed_ms ?? null,
       interval_ms: result.interval_ms ?? null,
       timeout_ms: result.timeout_ms ?? null,
@@ -13501,6 +13508,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       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 settleMs = Math.min(10000, Math.max(0, Math.floor(setupNumber(action.settle_ms ?? action.settleMs ?? action.predicate_settle_ms ?? action.predicateSettleMs ?? action.post_burst_wait_ms ?? action.postBurstWaitMs ?? action.after_burst_ms ?? action.afterBurstMs ?? action.settle_after_tap_ms ?? action.settleAfterTapMs, 0) || 0)));
       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);
@@ -13526,6 +13534,7 @@ async function executeSetupAction(action, ordinal, viewport) {
           max_calls: maxTaps,
           tap_burst_size: tapBurstSize,
           condition_check_count: conditionCheckCount,
+          settle_ms: settleMs,
           elapsed_ms: elapsedMs,
           interval_ms: intervalMs,
           timeout_ms: timeout,
@@ -13538,6 +13547,7 @@ async function executeSetupAction(action, ordinal, viewport) {
           tapCount += 1;
           if (tapCount < maxTaps && burstIndex < burstCount - 1 && intervalMs) await page.waitForTimeout(intervalMs);
         }
+        if (settleMs) await page.waitForTimeout(settleMs);
         lastPredicateResult = await setupReadWindowValue(scope.context, untilPath);
         conditionCheckCount += 1;
         if (lastPredicateResult.ok && setupValuesEqual(lastPredicateResult.value, untilExpected)) {
@@ -13555,6 +13565,7 @@ async function executeSetupAction(action, ordinal, viewport) {
             max_calls: maxTaps,
             tap_burst_size: tapBurstSize,
             condition_check_count: conditionCheckCount,
+            settle_ms: settleMs,
             elapsed_ms: elapsedMs,
             interval_ms: intervalMs,
             timeout_ms: timeout,
@@ -13575,6 +13586,7 @@ async function executeSetupAction(action, ordinal, viewport) {
         max_calls: maxTaps,
         tap_burst_size: tapBurstSize,
         condition_check_count: conditionCheckCount,
+        settle_ms: settleMs,
         elapsed_ms: elapsedMs,
         interval_ms: intervalMs,
         timeout_ms: timeout,
@@ -18084,6 +18096,7 @@ function profileSetupSummaryMarkdown(result) {
     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 settleMs = cliFiniteNumber(receipt.settle_ms);
     const elapsedMs3 = cliFiniteNumber(receipt.elapsed_ms);
     const ok = receipt.ok === false ? "failed" : "ok";
     const reason = cliString(receipt.reason);
@@ -18091,8 +18104,9 @@ function profileSetupSummaryMarkdown(result) {
     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)`;
+    const settleText = settleMs === void 0 || settleMs <= 0 ? "" : `, settle ${settleMs}ms`;
     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)}` : ""}`);
+    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}${settleText}${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-FNVDZCVZ.js";
+} from "./chunk-OUZKZ5U4.js";
 import {
   createRiddleApiClient,
   isTerminalRiddleJobStatus,
@@ -1921,6 +1921,7 @@ function profileSetupSummaryMarkdown(result) {
     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 settleMs = cliFiniteNumber(receipt.settle_ms);
     const elapsedMs = cliFiniteNumber(receipt.elapsed_ms);
     const ok = receipt.ok === false ? "failed" : "ok";
     const reason = cliString(receipt.reason);
@@ -1928,8 +1929,9 @@ function profileSetupSummaryMarkdown(result) {
     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)`;
+    const settleText = settleMs === void 0 || settleMs <= 0 ? "" : `, settle ${settleMs}ms`;
     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)}` : ""}`);
+    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}${settleText}${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

@@ -9368,6 +9368,7 @@ function profileSetupTapUntilReceipts(results) {
     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,
+    settle_ms: result.settle_ms ?? null,
     elapsed_ms: result.elapsed_ms ?? null,
     interval_ms: result.interval_ms ?? null,
     timeout_ms: result.timeout_ms ?? null,
@@ -10013,6 +10014,10 @@ function normalizeSetupAction(input, index) {
   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 settleMs = type === "tap_until" ? numberValue3(valueFromOwn(input, "settle_ms", "settleMs", "predicate_settle_ms", "predicateSettleMs", "post_burst_wait_ms", "postBurstWaitMs", "after_burst_ms", "afterBurstMs", "settle_after_tap_ms", "settleAfterTapMs")) : void 0;
+  if (type === "tap_until" && settleMs !== void 0 && (!Number.isInteger(settleMs) || settleMs < 0 || settleMs > 1e4)) {
+    throw new Error(`target.setup_actions[${index}].settle_ms must be an integer from 0 to 10000.`);
+  }
   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.`);
@@ -10061,6 +10066,7 @@ function normalizeSetupAction(input, index) {
     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,
+    settle_ms: settleMs,
     interval_ms: intervalMs,
     expected_value: hasExpectedValue ? toJsonValue(rawExpectedValue) : void 0,
     min_value: minValue,
@@ -13302,6 +13308,7 @@ function profileSetupTapUntilReceipts(results) {
       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,
+      settle_ms: result.settle_ms ?? null,
       elapsed_ms: result.elapsed_ms ?? null,
       interval_ms: result.interval_ms ?? null,
       timeout_ms: result.timeout_ms ?? null,
@@ -15293,6 +15300,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       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 settleMs = Math.min(10000, Math.max(0, Math.floor(setupNumber(action.settle_ms ?? action.settleMs ?? action.predicate_settle_ms ?? action.predicateSettleMs ?? action.post_burst_wait_ms ?? action.postBurstWaitMs ?? action.after_burst_ms ?? action.afterBurstMs ?? action.settle_after_tap_ms ?? action.settleAfterTapMs, 0) || 0)));
       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);
@@ -15318,6 +15326,7 @@ async function executeSetupAction(action, ordinal, viewport) {
           max_calls: maxTaps,
           tap_burst_size: tapBurstSize,
           condition_check_count: conditionCheckCount,
+          settle_ms: settleMs,
           elapsed_ms: elapsedMs,
           interval_ms: intervalMs,
           timeout_ms: timeout,
@@ -15330,6 +15339,7 @@ async function executeSetupAction(action, ordinal, viewport) {
           tapCount += 1;
           if (tapCount < maxTaps && burstIndex < burstCount - 1 && intervalMs) await page.waitForTimeout(intervalMs);
         }
+        if (settleMs) await page.waitForTimeout(settleMs);
         lastPredicateResult = await setupReadWindowValue(scope.context, untilPath);
         conditionCheckCount += 1;
         if (lastPredicateResult.ok && setupValuesEqual(lastPredicateResult.value, untilExpected)) {
@@ -15347,6 +15357,7 @@ async function executeSetupAction(action, ordinal, viewport) {
             max_calls: maxTaps,
             tap_burst_size: tapBurstSize,
             condition_check_count: conditionCheckCount,
+            settle_ms: settleMs,
             elapsed_ms: elapsedMs,
             interval_ms: intervalMs,
             timeout_ms: timeout,
@@ -15367,6 +15378,7 @@ async function executeSetupAction(action, ordinal, viewport) {
         max_calls: maxTaps,
         tap_burst_size: tapBurstSize,
         condition_check_count: conditionCheckCount,
+        settle_ms: settleMs,
         elapsed_ms: elapsedMs,
         interval_ms: intervalMs,
         timeout_ms: timeout,

package/dist/index.js

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

package/dist/profile.cjs

@@ -682,6 +682,7 @@ function profileSetupTapUntilReceipts(results) {
     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,
+    settle_ms: result.settle_ms ?? null,
     elapsed_ms: result.elapsed_ms ?? null,
     interval_ms: result.interval_ms ?? null,
     timeout_ms: result.timeout_ms ?? null,
@@ -1327,6 +1328,10 @@ function normalizeSetupAction(input, index) {
   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 settleMs = type === "tap_until" ? numberValue(valueFromOwn(input, "settle_ms", "settleMs", "predicate_settle_ms", "predicateSettleMs", "post_burst_wait_ms", "postBurstWaitMs", "after_burst_ms", "afterBurstMs", "settle_after_tap_ms", "settleAfterTapMs")) : void 0;
+  if (type === "tap_until" && settleMs !== void 0 && (!Number.isInteger(settleMs) || settleMs < 0 || settleMs > 1e4)) {
+    throw new Error(`target.setup_actions[${index}].settle_ms must be an integer from 0 to 10000.`);
+  }
   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.`);
@@ -1375,6 +1380,7 @@ function normalizeSetupAction(input, index) {
     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,
+    settle_ms: settleMs,
     interval_ms: intervalMs,
     expected_value: hasExpectedValue ? toJsonValue(rawExpectedValue) : void 0,
     min_value: minValue,
@@ -4616,6 +4622,7 @@ function profileSetupTapUntilReceipts(results) {
       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,
+      settle_ms: result.settle_ms ?? null,
       elapsed_ms: result.elapsed_ms ?? null,
       interval_ms: result.interval_ms ?? null,
       timeout_ms: result.timeout_ms ?? null,
@@ -6607,6 +6614,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       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 settleMs = Math.min(10000, Math.max(0, Math.floor(setupNumber(action.settle_ms ?? action.settleMs ?? action.predicate_settle_ms ?? action.predicateSettleMs ?? action.post_burst_wait_ms ?? action.postBurstWaitMs ?? action.after_burst_ms ?? action.afterBurstMs ?? action.settle_after_tap_ms ?? action.settleAfterTapMs, 0) || 0)));
       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);
@@ -6632,6 +6640,7 @@ async function executeSetupAction(action, ordinal, viewport) {
           max_calls: maxTaps,
           tap_burst_size: tapBurstSize,
           condition_check_count: conditionCheckCount,
+          settle_ms: settleMs,
           elapsed_ms: elapsedMs,
           interval_ms: intervalMs,
           timeout_ms: timeout,
@@ -6644,6 +6653,7 @@ async function executeSetupAction(action, ordinal, viewport) {
           tapCount += 1;
           if (tapCount < maxTaps && burstIndex < burstCount - 1 && intervalMs) await page.waitForTimeout(intervalMs);
         }
+        if (settleMs) await page.waitForTimeout(settleMs);
         lastPredicateResult = await setupReadWindowValue(scope.context, untilPath);
         conditionCheckCount += 1;
         if (lastPredicateResult.ok && setupValuesEqual(lastPredicateResult.value, untilExpected)) {
@@ -6661,6 +6671,7 @@ async function executeSetupAction(action, ordinal, viewport) {
             max_calls: maxTaps,
             tap_burst_size: tapBurstSize,
             condition_check_count: conditionCheckCount,
+            settle_ms: settleMs,
             elapsed_ms: elapsedMs,
             interval_ms: intervalMs,
             timeout_ms: timeout,
@@ -6681,6 +6692,7 @@ async function executeSetupAction(action, ordinal, viewport) {
         max_calls: maxTaps,
         tap_burst_size: tapBurstSize,
         condition_check_count: conditionCheckCount,
+        settle_ms: settleMs,
         elapsed_ms: elapsedMs,
         interval_ms: intervalMs,
         timeout_ms: timeout,

package/dist/profile.d.cts

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

package/dist/profile.d.ts

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

package/dist/profile.js

@@ -23,7 +23,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-FNVDZCVZ.js";
+} from "./chunk-OUZKZ5U4.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.200",
+  "version": "0.7.201",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",