@riddledc/riddle-proof 0.7.199 → 0.7.201

package/README.md

@@ -441,10 +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`, 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`
@@ -542,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,
-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-EXFYPLP2.js → chunk-OUZKZ5U4.js}

@@ -635,6 +635,8 @@ 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,
     reason: result.reason ?? result.error ?? null
@@ -1279,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.`);
@@ -1327,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,
@@ -4568,6 +4575,8 @@ 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,
       reason: result.reason || result.error || null,
@@ -6558,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);
@@ -6569,6 +6579,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       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),
@@ -6582,6 +6593,8 @@ 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,
         };
@@ -6593,9 +6606,11 @@ 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)) {
+          const elapsedMs = Date.now() - startedAt;
           return {
             ...base,
             ...setupScopeEvidence(scope),
@@ -6609,12 +6624,15 @@ 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,
           };
         }
         if (tapCount < maxTaps && intervalMs) await page.waitForTimeout(intervalMs);
       }
+      const elapsedMs = Date.now() - startedAt;
       return {
         ...base,
         ...setupScopeEvidence(scope),
@@ -6627,9 +6645,11 @@ 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,
-        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

@@ -7592,6 +7592,8 @@ 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,
     reason: result.reason ?? result.error ?? null
@@ -8236,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.`);
@@ -8284,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,
@@ -11509,6 +11516,8 @@ 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,
       reason: result.reason || result.error || null,
@@ -13499,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);
@@ -13510,6 +13520,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       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),
@@ -13523,6 +13534,8 @@ 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,
         };
@@ -13534,9 +13547,11 @@ 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)) {
+          const elapsedMs = Date.now() - startedAt;
           return {
             ...base,
             ...setupScopeEvidence(scope),
@@ -13550,12 +13565,15 @@ 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,
           };
         }
         if (tapCount < maxTaps && intervalMs) await page.waitForTimeout(intervalMs);
       }
+      const elapsedMs = Date.now() - startedAt;
       return {
         ...base,
         ...setupScopeEvidence(scope),
@@ -13568,9 +13586,11 @@ 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,
-        reason: Date.now() - startedAt > timeout ? "timeout" : "until_condition_not_met",
+        reason: elapsedMs > timeout ? "timeout" : "until_condition_not_met",
         missing_part: lastPredicateResult?.missing_part || undefined,
       };
     }
@@ -18076,13 +18096,17 @@ 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);
     const coordinateText = x && y ? `, ${coordinateMode ? `${coordinateMode} ` : ""}${markdownInlineCode(`${x},${y}`)}` : "";
     const tapText = tapCount === void 0 ? "" : ` in ${tapCount}${maxTaps === void 0 ? "" : `/${maxTaps}`} tap(s)`;
     const burstText = tapBurstSize === void 0 || tapBurstSize <= 1 ? "" : `, burst ${tapBurstSize}`;
     const conditionCheckText = conditionCheckCount === void 0 ? "" : `, ${conditionCheckCount} check(s)`;
-    lines.push(`- ${name} tap_until: ${ok}, ${markdownInlineCode(selector)}${pointerType ? ` ${markdownInlineCode(pointerType)}` : ""}${inputDispatch ? ` via ${markdownInlineCode(inputDispatch)}` : ""}${coordinateText}${durationMs === void 0 ? "" : `, duration ${durationMs}ms`} until ${markdownInlineCode(untilPath)}${expected === void 0 ? "" : ` == ${markdownInlineCode(expected, 80)}`}${tapText}${burstText}${conditionCheckText}${actual === void 0 ? "" : `, observed ${markdownInlineCode(actual, 80)}`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
+    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}${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-EXFYPLP2.js";
+} from "./chunk-OUZKZ5U4.js";
 import {
   createRiddleApiClient,
   isTerminalRiddleJobStatus,
@@ -1921,13 +1921,17 @@ 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);
     const coordinateText = x && y ? `, ${coordinateMode ? `${coordinateMode} ` : ""}${markdownInlineCode(`${x},${y}`)}` : "";
     const tapText = tapCount === void 0 ? "" : ` in ${tapCount}${maxTaps === void 0 ? "" : `/${maxTaps}`} tap(s)`;
     const burstText = tapBurstSize === void 0 || tapBurstSize <= 1 ? "" : `, burst ${tapBurstSize}`;
     const conditionCheckText = conditionCheckCount === void 0 ? "" : `, ${conditionCheckCount} check(s)`;
-    lines.push(`- ${name} tap_until: ${ok}, ${markdownInlineCode(selector)}${pointerType ? ` ${markdownInlineCode(pointerType)}` : ""}${inputDispatch ? ` via ${markdownInlineCode(inputDispatch)}` : ""}${coordinateText}${durationMs === void 0 ? "" : `, duration ${durationMs}ms`} until ${markdownInlineCode(untilPath)}${expected === void 0 ? "" : ` == ${markdownInlineCode(expected, 80)}`}${tapText}${burstText}${conditionCheckText}${actual === void 0 ? "" : `, observed ${markdownInlineCode(actual, 80)}`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
+    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}${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,8 @@ 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,
     reason: result.reason ?? result.error ?? null
@@ -10012,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.`);
@@ -10060,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,
@@ -13301,6 +13308,8 @@ 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,
       reason: result.reason || result.error || null,
@@ -15291,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);
@@ -15302,6 +15312,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       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),
@@ -15315,6 +15326,8 @@ 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,
         };
@@ -15326,9 +15339,11 @@ 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)) {
+          const elapsedMs = Date.now() - startedAt;
           return {
             ...base,
             ...setupScopeEvidence(scope),
@@ -15342,12 +15357,15 @@ 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,
           };
         }
         if (tapCount < maxTaps && intervalMs) await page.waitForTimeout(intervalMs);
       }
+      const elapsedMs = Date.now() - startedAt;
       return {
         ...base,
         ...setupScopeEvidence(scope),
@@ -15360,9 +15378,11 @@ 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,
-        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-EXFYPLP2.js";
+} from "./chunk-OUZKZ5U4.js";
 import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,

package/dist/profile.cjs

@@ -682,6 +682,8 @@ 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,
     reason: result.reason ?? result.error ?? null
@@ -1326,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.`);
@@ -1374,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,
@@ -4615,6 +4622,8 @@ 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,
       reason: result.reason || result.error || null,
@@ -6605,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);
@@ -6616,6 +6626,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       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),
@@ -6629,6 +6640,8 @@ 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,
         };
@@ -6640,9 +6653,11 @@ 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)) {
+          const elapsedMs = Date.now() - startedAt;
           return {
             ...base,
             ...setupScopeEvidence(scope),
@@ -6656,12 +6671,15 @@ 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,
           };
         }
         if (tapCount < maxTaps && intervalMs) await page.waitForTimeout(intervalMs);
       }
+      const elapsedMs = Date.now() - startedAt;
       return {
         ...base,
         ...setupScopeEvidence(scope),
@@ -6674,9 +6692,11 @@ 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,
-        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

@@ -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-EXFYPLP2.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.199",
+  "version": "0.7.201",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",