@riddledc/riddle-proof 0.7.171 → 0.7.172

package/dist/index.cjs

@@ -8782,6 +8782,7 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "fill",
   "set_input_value",
   "set_range_value",
+  "deterministic_runtime",
   "canvas_signature",
   "assert_text_visible",
   "assert_text_absent",
@@ -9244,6 +9245,23 @@ function profileSetupWindowEvalReceipts(results) {
     return receipt;
   });
 }
+function profileSetupDeterministicRuntimeReceipts(results) {
+  return results.filter((result) => profileSetupResultAction(result) === "deterministic_runtime").map((result) => ({
+    ordinal: result.ordinal ?? null,
+    ok: result.ok !== false,
+    random_enabled: result.random_enabled ?? null,
+    random_queue_added: result.random_queue_added ?? null,
+    random_queue_length: result.random_queue_length ?? null,
+    random_queue_mode: result.random_queue_mode ?? null,
+    random_underflow_count: result.random_underflow_count ?? null,
+    clock_enabled: result.clock_enabled ?? null,
+    previous_now: result.previous_now ?? null,
+    now: result.now ?? null,
+    advance_ms: result.advance_ms ?? null,
+    restored: result.restored ?? null,
+    reason: result.reason ?? result.error ?? null
+  }));
+}
 function profileSetupReturnSummaryFields(result) {
   const input = result.return_summary_fields;
   if (!Array.isArray(input)) return [];
@@ -9458,6 +9476,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
       const windowEvalStoredTotal = windowEvalReceipts.filter((result) => typeof result.return_stored_to === "string" && result.return_stored_to.trim()).length;
       const windowEvalCapturedTotal = windowEvalReceipts.filter((result) => result.return_captured === true).length;
       const sampledWindowEvalReceipts = sampleProfileSetupSummaryItems(windowEvalReceipts, 8);
+      const deterministicRuntimeReceipts = profileSetupDeterministicRuntimeReceipts(results);
+      const sampledDeterministicRuntimeReceipts = sampleProfileSetupSummaryItems(deterministicRuntimeReceipts, 8);
       const rangeValueReceipts = profileSetupRangeValueReceipts(results);
       const sampledRangeValueReceipts = sampleProfileSetupSummaryItems(rangeValueReceipts, 8);
       const dragReceipts = profileSetupDragReceipts(results);
@@ -9517,6 +9537,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
         window_eval_captured_total: windowEvalCapturedTotal,
         window_eval_truncated: windowEvalReceipts.length > sampledWindowEvalReceipts.length,
         window_eval: sampledWindowEvalReceipts,
+        deterministic_runtime_total: deterministicRuntimeReceipts.length,
+        deterministic_runtime_truncated: deterministicRuntimeReceipts.length > sampledDeterministicRuntimeReceipts.length,
+        deterministic_runtime: sampledDeterministicRuntimeReceipts,
         set_range_value_total: rangeValueReceipts.length,
         set_range_value_truncated: rangeValueReceipts.length > sampledRangeValueReceipts.length,
         set_range_value: sampledRangeValueReceipts,
@@ -9579,7 +9602,7 @@ function isSupportedCheckType(value) {
 }
 function normalizeSetupActionType(value, index) {
   const normalizedInput = String(value || "").trim().replace(/-/g, "_");
-  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "reset_console" || normalizedInput === "clear_browser_console" || normalizedInput === "reset_browser_console" ? "clear_console" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput === "set_slider_value" || normalizedInput === "slider_value" || normalizedInput === "set_slider" || normalizedInput === "set_range" || normalizedInput === "range_value" || normalizedInput === "range_input" || normalizedInput === "set_range_input" ? "set_range_value" : normalizedInput === "canvas_hash" || normalizedInput === "capture_canvas_hash" || normalizedInput === "capture_canvas_signature" || normalizedInput === "canvas_state_signature" ? "canvas_signature" : normalizedInput === "capture_screenshot" || normalizedInput === "save_screenshot" || normalizedInput === "setup_screenshot" ? "screenshot" : normalizedInput === "accept_dialog" || normalizedInput === "accept_dialogs" || normalizedInput === "confirm_dialog" || normalizedInput === "set_dialog_response" ? "dialog_response" : normalizedInput === "dismiss_dialog" || normalizedInput === "dismiss_dialogs" || normalizedInput === "cancel_dialog" ? "dialog_response" : normalizedInput === "window_call_until" || normalizedInput === "call_until" || normalizedInput === "window_call_repeat_until" || normalizedInput === "repeat_window_call_until" ? "window_call_until" : normalizedInput === "window_evaluate" || normalizedInput === "browser_eval" || normalizedInput === "browser_evaluate" || normalizedInput === "evaluate_script" || normalizedInput === "profile_script" ? "window_eval" : normalizedInput;
+  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "reset_console" || normalizedInput === "clear_browser_console" || normalizedInput === "reset_browser_console" ? "clear_console" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput === "set_slider_value" || normalizedInput === "slider_value" || normalizedInput === "set_slider" || normalizedInput === "set_range" || normalizedInput === "range_value" || normalizedInput === "range_input" || normalizedInput === "set_range_input" ? "set_range_value" : normalizedInput === "deterministic_runtime" || normalizedInput === "mock_runtime" || normalizedInput === "mock_random" || normalizedInput === "mock_random_queue" || normalizedInput === "seed_random_queue" || normalizedInput === "set_random_queue" || normalizedInput === "mock_clock" || normalizedInput === "set_mock_clock" || normalizedInput === "set_runtime_determinism" || normalizedInput === "runtime_determinism" ? "deterministic_runtime" : normalizedInput === "canvas_hash" || normalizedInput === "capture_canvas_hash" || normalizedInput === "capture_canvas_signature" || normalizedInput === "canvas_state_signature" ? "canvas_signature" : normalizedInput === "capture_screenshot" || normalizedInput === "save_screenshot" || normalizedInput === "setup_screenshot" ? "screenshot" : normalizedInput === "accept_dialog" || normalizedInput === "accept_dialogs" || normalizedInput === "confirm_dialog" || normalizedInput === "set_dialog_response" ? "dialog_response" : normalizedInput === "dismiss_dialog" || normalizedInput === "dismiss_dialogs" || normalizedInput === "cancel_dialog" ? "dialog_response" : normalizedInput === "window_call_until" || normalizedInput === "call_until" || normalizedInput === "window_call_repeat_until" || normalizedInput === "repeat_window_call_until" ? "window_call_until" : normalizedInput === "window_evaluate" || normalizedInput === "browser_eval" || normalizedInput === "browser_evaluate" || normalizedInput === "evaluate_script" || normalizedInput === "profile_script" ? "window_eval" : normalizedInput;
   if (RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.includes(normalized)) {
     return normalized;
   }
@@ -9698,6 +9721,39 @@ function normalizeSetupActionScreenshotFullPage(input, type, index) {
   }
   return values[0];
 }
+function normalizeSetupActionRandomQueue(input, index) {
+  const rawQueue = valueFromOwn(
+    input,
+    "random_queue",
+    "randomQueue",
+    "random_values",
+    "randomValues",
+    "random_sequence",
+    "randomSequence",
+    "math_random",
+    "mathRandom"
+  );
+  if (rawQueue === void 0) return void 0;
+  if (!Array.isArray(rawQueue) || rawQueue.length === 0) {
+    throw new Error(`target.setup_actions[${index}].random_queue must be a non-empty array of numbers from 0 inclusive to 1 exclusive.`);
+  }
+  return rawQueue.map((item, queueIndex) => {
+    const value = numberValue3(item);
+    if (value === void 0 || value < 0 || value >= 1) {
+      throw new Error(`target.setup_actions[${index}].random_queue[${queueIndex}] must be a finite number from 0 inclusive to 1 exclusive.`);
+    }
+    return value;
+  });
+}
+function normalizeSetupActionNonNegativeNumber(input, index, outputKey, ...keys) {
+  const rawValue = valueFromOwn(input, ...keys);
+  if (rawValue === void 0) return void 0;
+  const value = numberValue3(rawValue);
+  if (value === void 0 || value < 0) {
+    throw new Error(`target.setup_actions[${index}].${outputKey} must be a finite non-negative number.`);
+  }
+  return value;
+}
 function normalizeSetupAction(input, index) {
   if (!isRecord2(input)) throw new Error(`target.setup_actions[${index}] must be an object.`);
   const type = normalizeSetupActionType(stringValue5(input.type), index);
@@ -9758,6 +9814,14 @@ function normalizeSetupAction(input, index) {
   if ((type === "fill" || type === "set_input_value" || type === "set_range_value") && value === void 0 && !hasJsonValue) {
     throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
+  const randomQueue = type === "deterministic_runtime" ? normalizeSetupActionRandomQueue(input, index) : void 0;
+  const deterministicNow = type === "deterministic_runtime" ? normalizeSetupActionNonNegativeNumber(input, index, "now", "now", "date_now", "dateNow", "mock_now", "mockNow", "clock", "timestamp", "time_ms", "timeMs") : void 0;
+  const deterministicAdvanceMs = type === "deterministic_runtime" ? normalizeSetupActionNonNegativeNumber(input, index, "advance_ms", "advance_ms", "advanceMs", "tick_ms", "tickMs", "add_ms", "addMs") : void 0;
+  const deterministicAppend = type === "deterministic_runtime" && booleanValue(valueFromOwn(input, "append", "append_random", "appendRandom")) === true;
+  const deterministicRestore = type === "deterministic_runtime" && booleanValue(valueFromOwn(input, "restore", "reset", "restore_originals", "restoreOriginals")) === true;
+  if (type === "deterministic_runtime" && randomQueue === void 0 && deterministicNow === void 0 && deterministicAdvanceMs === void 0 && !deterministicRestore) {
+    throw new Error(`target.setup_actions[${index}] deterministic_runtime requires random_queue, now, advance_ms, or restore.`);
+  }
   const key = stringValue5(input.key);
   let dialogAccept;
   if (type === "dialog_response") {
@@ -9865,6 +9929,11 @@ function normalizeSetupAction(input, index) {
     key,
     value,
     value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
+    random_queue: randomQueue,
+    now: deterministicNow,
+    advance_ms: deterministicAdvanceMs,
+    append: deterministicAppend || void 0,
+    restore: deterministicRestore || void 0,
     label: stringFromOwn(input, "label", "name", "screenshot_label", "screenshotLabel"),
     script,
     path: path6,
@@ -12941,6 +13010,25 @@ function profileSetupWindowEvalReceipts(results) {
       return receipt;
     });
 }
+function profileSetupDeterministicRuntimeReceipts(results) {
+  return (results || [])
+    .filter((result) => result && profileSetupResultAction(result) === "deterministic_runtime")
+    .map((result) => ({
+      ordinal: result.ordinal ?? null,
+      ok: result.ok !== false,
+      random_enabled: result.random_enabled ?? null,
+      random_queue_added: result.random_queue_added ?? null,
+      random_queue_length: result.random_queue_length ?? null,
+      random_queue_mode: result.random_queue_mode ?? null,
+      random_underflow_count: result.random_underflow_count ?? null,
+      clock_enabled: result.clock_enabled ?? null,
+      previous_now: result.previous_now ?? null,
+      now: result.now ?? null,
+      advance_ms: result.advance_ms ?? null,
+      restored: result.restored ?? null,
+      reason: result.reason || result.error || null,
+    }));
+}
 function profileSetupReturnSummaryFields(result) {
   const input = result && result.return_summary_fields;
   if (!Array.isArray(input)) return [];
@@ -13184,6 +13272,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
       const windowEvalStoredTotal = windowEvalReceipts.filter((result) => typeof result.return_stored_to === "string" && result.return_stored_to.trim()).length;
       const windowEvalCapturedTotal = windowEvalReceipts.filter((result) => result.return_captured === true).length;
       const sampledWindowEvalReceipts = sampleProfileSetupSummaryItems(windowEvalReceipts, 8);
+      const deterministicRuntimeReceipts = profileSetupDeterministicRuntimeReceipts(results);
+      const sampledDeterministicRuntimeReceipts = sampleProfileSetupSummaryItems(deterministicRuntimeReceipts, 8);
       const rangeValueReceipts = profileSetupRangeValueReceipts(results);
       const sampledRangeValueReceipts = sampleProfileSetupSummaryItems(rangeValueReceipts, 8);
       const dragReceipts = profileSetupDragReceipts(results);
@@ -13253,6 +13343,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         window_eval_captured_total: windowEvalCapturedTotal,
         window_eval_truncated: windowEvalReceipts.length > sampledWindowEvalReceipts.length,
         window_eval: sampledWindowEvalReceipts,
+        deterministic_runtime_total: deterministicRuntimeReceipts.length,
+        deterministic_runtime_truncated: deterministicRuntimeReceipts.length > sampledDeterministicRuntimeReceipts.length,
+        deterministic_runtime: sampledDeterministicRuntimeReceipts,
         set_range_value_total: rangeValueReceipts.length,
         set_range_value_truncated: rangeValueReceipts.length > sampledRangeValueReceipts.length,
         set_range_value: sampledRangeValueReceipts,
@@ -14874,6 +14967,111 @@ async function executeSetupAction(action, ordinal, viewport) {
       }
       return { ...base, ...setupScopeEvidence(scope), ok: true, storage, reload: action.reload === true };
     }
+    if (type === "deterministic_runtime") {
+      const scope = await setupActionScope(action, timeout);
+      if (!scope.ok) return setupScopeFailure(base, scope);
+      const randomQueue = Array.isArray(action.random_queue)
+        ? action.random_queue
+        : Array.isArray(action.randomQueue)
+          ? action.randomQueue
+          : null;
+      const now = setupFiniteNumber(action.now ?? action.date_now ?? action.dateNow ?? action.mock_now ?? action.mockNow ?? action.clock ?? action.timestamp ?? action.time_ms ?? action.timeMs);
+      const advanceMs = setupFiniteNumber(action.advance_ms ?? action.advanceMs ?? action.tick_ms ?? action.tickMs ?? action.add_ms ?? action.addMs);
+      const append = action.append === true || action.append_random === true || action.appendRandom === true;
+      const restore = action.restore === true || action.reset === true || action.restore_originals === true || action.restoreOriginals === true;
+      const runtimeResult = await scope.context.evaluate((payload) => {
+        const root = window;
+        const stateKey = "__RIDDLE_PROOF_DETERMINISTIC_RUNTIME__";
+        const state = root[stateKey] && typeof root[stateKey] === "object" && !Array.isArray(root[stateKey])
+          ? root[stateKey]
+          : {};
+        root[stateKey] = state;
+        if (typeof state.originalRandom !== "function") state.originalRandom = Math.random;
+        if (typeof state.originalDateNow !== "function") state.originalDateNow = Date.now;
+        const previousNow = typeof state.now === "number" && Number.isFinite(state.now)
+          ? state.now
+          : Date.now === state.originalDateNow
+            ? null
+            : Date.now();
+        if (payload.restore) {
+          Math.random = state.originalRandom;
+          Date.now = state.originalDateNow;
+          delete root[stateKey];
+          return {
+            ok: true,
+            restored: true,
+            random_enabled: false,
+            random_queue_added: 0,
+            random_queue_length: 0,
+            random_queue_mode: null,
+            random_underflow_count: typeof state.randomUnderflowCount === "number" ? state.randomUnderflowCount : 0,
+            clock_enabled: false,
+            previous_now: previousNow,
+            now: null,
+            advance_ms: null,
+          };
+        }
+        let randomQueueAdded = null;
+        let randomQueueMode = null;
+        if (Array.isArray(payload.random_queue)) {
+          const queue = payload.random_queue.filter((value) => typeof value === "number" && Number.isFinite(value) && value >= 0 && value < 1);
+          const existing = Array.isArray(state.randomQueue) ? state.randomQueue : [];
+          state.randomQueue = payload.append ? existing.concat(queue) : queue.slice();
+          randomQueueAdded = queue.length;
+          randomQueueMode = payload.append ? "append" : "replace";
+          Math.random = function riddleProofMockRandom() {
+            const activeQueue = Array.isArray(state.randomQueue) ? state.randomQueue : [];
+            if (activeQueue.length) return activeQueue.shift();
+            state.randomUnderflowCount = (typeof state.randomUnderflowCount === "number" ? state.randomUnderflowCount : 0) + 1;
+            return 0;
+          };
+        }
+        if (typeof payload.now === "number" && Number.isFinite(payload.now)) {
+          state.now = payload.now;
+          Date.now = function riddleProofMockDateNow() {
+            return state.now;
+          };
+        }
+        if (typeof payload.advance_ms === "number" && Number.isFinite(payload.advance_ms)) {
+          const baseNow = typeof state.now === "number" && Number.isFinite(state.now)
+            ? state.now
+            : Date.now();
+          state.now = baseNow + payload.advance_ms;
+          Date.now = function riddleProofMockDateNow() {
+            return state.now;
+          };
+        }
+        return {
+          ok: true,
+          restored: false,
+          random_enabled: Math.random !== state.originalRandom,
+          random_queue_added: randomQueueAdded,
+          random_queue_length: Array.isArray(state.randomQueue) ? state.randomQueue.length : 0,
+          random_queue_mode: randomQueueMode,
+          random_underflow_count: typeof state.randomUnderflowCount === "number" ? state.randomUnderflowCount : 0,
+          clock_enabled: Date.now !== state.originalDateNow,
+          previous_now: previousNow,
+          now: typeof state.now === "number" && Number.isFinite(state.now) ? state.now : null,
+          advance_ms: typeof payload.advance_ms === "number" && Number.isFinite(payload.advance_ms) ? payload.advance_ms : null,
+        };
+      }, { random_queue: randomQueue, now, advance_ms: advanceMs, append, restore });
+      return {
+        ...base,
+        ...setupScopeEvidence(scope),
+        ok: runtimeResult && runtimeResult.ok === true,
+        random_enabled: runtimeResult?.random_enabled,
+        random_queue_added: runtimeResult?.random_queue_added,
+        random_queue_length: runtimeResult?.random_queue_length,
+        random_queue_mode: runtimeResult?.random_queue_mode,
+        random_underflow_count: runtimeResult?.random_underflow_count,
+        clock_enabled: runtimeResult?.clock_enabled,
+        previous_now: runtimeResult?.previous_now,
+        now: runtimeResult?.now,
+        advance_ms: runtimeResult?.advance_ms,
+        restored: runtimeResult?.restored,
+        reason: runtimeResult && runtimeResult.ok === true ? undefined : runtimeResult?.reason || "deterministic_runtime_not_applied",
+      };
+    }
     if (type === "window_eval") {
       const script = String(action.script || action.code || action.source || action.body || "");
       const args = Array.isArray(action.args) ? action.args : [];

package/dist/index.js

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

package/dist/profile.cjs

@@ -96,6 +96,7 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "fill",
   "set_input_value",
   "set_range_value",
+  "deterministic_runtime",
   "canvas_signature",
   "assert_text_visible",
   "assert_text_absent",
@@ -558,6 +559,23 @@ function profileSetupWindowEvalReceipts(results) {
     return receipt;
   });
 }
+function profileSetupDeterministicRuntimeReceipts(results) {
+  return results.filter((result) => profileSetupResultAction(result) === "deterministic_runtime").map((result) => ({
+    ordinal: result.ordinal ?? null,
+    ok: result.ok !== false,
+    random_enabled: result.random_enabled ?? null,
+    random_queue_added: result.random_queue_added ?? null,
+    random_queue_length: result.random_queue_length ?? null,
+    random_queue_mode: result.random_queue_mode ?? null,
+    random_underflow_count: result.random_underflow_count ?? null,
+    clock_enabled: result.clock_enabled ?? null,
+    previous_now: result.previous_now ?? null,
+    now: result.now ?? null,
+    advance_ms: result.advance_ms ?? null,
+    restored: result.restored ?? null,
+    reason: result.reason ?? result.error ?? null
+  }));
+}
 function profileSetupReturnSummaryFields(result) {
   const input = result.return_summary_fields;
   if (!Array.isArray(input)) return [];
@@ -772,6 +790,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
       const windowEvalStoredTotal = windowEvalReceipts.filter((result) => typeof result.return_stored_to === "string" && result.return_stored_to.trim()).length;
       const windowEvalCapturedTotal = windowEvalReceipts.filter((result) => result.return_captured === true).length;
       const sampledWindowEvalReceipts = sampleProfileSetupSummaryItems(windowEvalReceipts, 8);
+      const deterministicRuntimeReceipts = profileSetupDeterministicRuntimeReceipts(results);
+      const sampledDeterministicRuntimeReceipts = sampleProfileSetupSummaryItems(deterministicRuntimeReceipts, 8);
       const rangeValueReceipts = profileSetupRangeValueReceipts(results);
       const sampledRangeValueReceipts = sampleProfileSetupSummaryItems(rangeValueReceipts, 8);
       const dragReceipts = profileSetupDragReceipts(results);
@@ -831,6 +851,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
         window_eval_captured_total: windowEvalCapturedTotal,
         window_eval_truncated: windowEvalReceipts.length > sampledWindowEvalReceipts.length,
         window_eval: sampledWindowEvalReceipts,
+        deterministic_runtime_total: deterministicRuntimeReceipts.length,
+        deterministic_runtime_truncated: deterministicRuntimeReceipts.length > sampledDeterministicRuntimeReceipts.length,
+        deterministic_runtime: sampledDeterministicRuntimeReceipts,
         set_range_value_total: rangeValueReceipts.length,
         set_range_value_truncated: rangeValueReceipts.length > sampledRangeValueReceipts.length,
         set_range_value: sampledRangeValueReceipts,
@@ -893,7 +916,7 @@ function isSupportedCheckType(value) {
 }
 function normalizeSetupActionType(value, index) {
   const normalizedInput = String(value || "").trim().replace(/-/g, "_");
-  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "reset_console" || normalizedInput === "clear_browser_console" || normalizedInput === "reset_browser_console" ? "clear_console" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput === "set_slider_value" || normalizedInput === "slider_value" || normalizedInput === "set_slider" || normalizedInput === "set_range" || normalizedInput === "range_value" || normalizedInput === "range_input" || normalizedInput === "set_range_input" ? "set_range_value" : normalizedInput === "canvas_hash" || normalizedInput === "capture_canvas_hash" || normalizedInput === "capture_canvas_signature" || normalizedInput === "canvas_state_signature" ? "canvas_signature" : normalizedInput === "capture_screenshot" || normalizedInput === "save_screenshot" || normalizedInput === "setup_screenshot" ? "screenshot" : normalizedInput === "accept_dialog" || normalizedInput === "accept_dialogs" || normalizedInput === "confirm_dialog" || normalizedInput === "set_dialog_response" ? "dialog_response" : normalizedInput === "dismiss_dialog" || normalizedInput === "dismiss_dialogs" || normalizedInput === "cancel_dialog" ? "dialog_response" : normalizedInput === "window_call_until" || normalizedInput === "call_until" || normalizedInput === "window_call_repeat_until" || normalizedInput === "repeat_window_call_until" ? "window_call_until" : normalizedInput === "window_evaluate" || normalizedInput === "browser_eval" || normalizedInput === "browser_evaluate" || normalizedInput === "evaluate_script" || normalizedInput === "profile_script" ? "window_eval" : normalizedInput;
+  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "reset_console" || normalizedInput === "clear_browser_console" || normalizedInput === "reset_browser_console" ? "clear_console" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput === "set_slider_value" || normalizedInput === "slider_value" || normalizedInput === "set_slider" || normalizedInput === "set_range" || normalizedInput === "range_value" || normalizedInput === "range_input" || normalizedInput === "set_range_input" ? "set_range_value" : normalizedInput === "deterministic_runtime" || normalizedInput === "mock_runtime" || normalizedInput === "mock_random" || normalizedInput === "mock_random_queue" || normalizedInput === "seed_random_queue" || normalizedInput === "set_random_queue" || normalizedInput === "mock_clock" || normalizedInput === "set_mock_clock" || normalizedInput === "set_runtime_determinism" || normalizedInput === "runtime_determinism" ? "deterministic_runtime" : normalizedInput === "canvas_hash" || normalizedInput === "capture_canvas_hash" || normalizedInput === "capture_canvas_signature" || normalizedInput === "canvas_state_signature" ? "canvas_signature" : normalizedInput === "capture_screenshot" || normalizedInput === "save_screenshot" || normalizedInput === "setup_screenshot" ? "screenshot" : normalizedInput === "accept_dialog" || normalizedInput === "accept_dialogs" || normalizedInput === "confirm_dialog" || normalizedInput === "set_dialog_response" ? "dialog_response" : normalizedInput === "dismiss_dialog" || normalizedInput === "dismiss_dialogs" || normalizedInput === "cancel_dialog" ? "dialog_response" : normalizedInput === "window_call_until" || normalizedInput === "call_until" || normalizedInput === "window_call_repeat_until" || normalizedInput === "repeat_window_call_until" ? "window_call_until" : normalizedInput === "window_evaluate" || normalizedInput === "browser_eval" || normalizedInput === "browser_evaluate" || normalizedInput === "evaluate_script" || normalizedInput === "profile_script" ? "window_eval" : normalizedInput;
   if (RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.includes(normalized)) {
     return normalized;
   }
@@ -1012,6 +1035,39 @@ function normalizeSetupActionScreenshotFullPage(input, type, index) {
   }
   return values[0];
 }
+function normalizeSetupActionRandomQueue(input, index) {
+  const rawQueue = valueFromOwn(
+    input,
+    "random_queue",
+    "randomQueue",
+    "random_values",
+    "randomValues",
+    "random_sequence",
+    "randomSequence",
+    "math_random",
+    "mathRandom"
+  );
+  if (rawQueue === void 0) return void 0;
+  if (!Array.isArray(rawQueue) || rawQueue.length === 0) {
+    throw new Error(`target.setup_actions[${index}].random_queue must be a non-empty array of numbers from 0 inclusive to 1 exclusive.`);
+  }
+  return rawQueue.map((item, queueIndex) => {
+    const value = numberValue(item);
+    if (value === void 0 || value < 0 || value >= 1) {
+      throw new Error(`target.setup_actions[${index}].random_queue[${queueIndex}] must be a finite number from 0 inclusive to 1 exclusive.`);
+    }
+    return value;
+  });
+}
+function normalizeSetupActionNonNegativeNumber(input, index, outputKey, ...keys) {
+  const rawValue = valueFromOwn(input, ...keys);
+  if (rawValue === void 0) return void 0;
+  const value = numberValue(rawValue);
+  if (value === void 0 || value < 0) {
+    throw new Error(`target.setup_actions[${index}].${outputKey} must be a finite non-negative number.`);
+  }
+  return value;
+}
 function normalizeSetupAction(input, index) {
   if (!isRecord(input)) throw new Error(`target.setup_actions[${index}] must be an object.`);
   const type = normalizeSetupActionType(stringValue(input.type), index);
@@ -1072,6 +1128,14 @@ function normalizeSetupAction(input, index) {
   if ((type === "fill" || type === "set_input_value" || type === "set_range_value") && value === void 0 && !hasJsonValue) {
     throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
+  const randomQueue = type === "deterministic_runtime" ? normalizeSetupActionRandomQueue(input, index) : void 0;
+  const deterministicNow = type === "deterministic_runtime" ? normalizeSetupActionNonNegativeNumber(input, index, "now", "now", "date_now", "dateNow", "mock_now", "mockNow", "clock", "timestamp", "time_ms", "timeMs") : void 0;
+  const deterministicAdvanceMs = type === "deterministic_runtime" ? normalizeSetupActionNonNegativeNumber(input, index, "advance_ms", "advance_ms", "advanceMs", "tick_ms", "tickMs", "add_ms", "addMs") : void 0;
+  const deterministicAppend = type === "deterministic_runtime" && booleanValue(valueFromOwn(input, "append", "append_random", "appendRandom")) === true;
+  const deterministicRestore = type === "deterministic_runtime" && booleanValue(valueFromOwn(input, "restore", "reset", "restore_originals", "restoreOriginals")) === true;
+  if (type === "deterministic_runtime" && randomQueue === void 0 && deterministicNow === void 0 && deterministicAdvanceMs === void 0 && !deterministicRestore) {
+    throw new Error(`target.setup_actions[${index}] deterministic_runtime requires random_queue, now, advance_ms, or restore.`);
+  }
   const key = stringValue(input.key);
   let dialogAccept;
   if (type === "dialog_response") {
@@ -1179,6 +1243,11 @@ function normalizeSetupAction(input, index) {
     key,
     value,
     value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
+    random_queue: randomQueue,
+    now: deterministicNow,
+    advance_ms: deterministicAdvanceMs,
+    append: deterministicAppend || void 0,
+    restore: deterministicRestore || void 0,
     label: stringFromOwn(input, "label", "name", "screenshot_label", "screenshotLabel"),
     script,
     path,
@@ -4255,6 +4324,25 @@ function profileSetupWindowEvalReceipts(results) {
       return receipt;
     });
 }
+function profileSetupDeterministicRuntimeReceipts(results) {
+  return (results || [])
+    .filter((result) => result && profileSetupResultAction(result) === "deterministic_runtime")
+    .map((result) => ({
+      ordinal: result.ordinal ?? null,
+      ok: result.ok !== false,
+      random_enabled: result.random_enabled ?? null,
+      random_queue_added: result.random_queue_added ?? null,
+      random_queue_length: result.random_queue_length ?? null,
+      random_queue_mode: result.random_queue_mode ?? null,
+      random_underflow_count: result.random_underflow_count ?? null,
+      clock_enabled: result.clock_enabled ?? null,
+      previous_now: result.previous_now ?? null,
+      now: result.now ?? null,
+      advance_ms: result.advance_ms ?? null,
+      restored: result.restored ?? null,
+      reason: result.reason || result.error || null,
+    }));
+}
 function profileSetupReturnSummaryFields(result) {
   const input = result && result.return_summary_fields;
   if (!Array.isArray(input)) return [];
@@ -4498,6 +4586,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
       const windowEvalStoredTotal = windowEvalReceipts.filter((result) => typeof result.return_stored_to === "string" && result.return_stored_to.trim()).length;
       const windowEvalCapturedTotal = windowEvalReceipts.filter((result) => result.return_captured === true).length;
       const sampledWindowEvalReceipts = sampleProfileSetupSummaryItems(windowEvalReceipts, 8);
+      const deterministicRuntimeReceipts = profileSetupDeterministicRuntimeReceipts(results);
+      const sampledDeterministicRuntimeReceipts = sampleProfileSetupSummaryItems(deterministicRuntimeReceipts, 8);
       const rangeValueReceipts = profileSetupRangeValueReceipts(results);
       const sampledRangeValueReceipts = sampleProfileSetupSummaryItems(rangeValueReceipts, 8);
       const dragReceipts = profileSetupDragReceipts(results);
@@ -4567,6 +4657,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         window_eval_captured_total: windowEvalCapturedTotal,
         window_eval_truncated: windowEvalReceipts.length > sampledWindowEvalReceipts.length,
         window_eval: sampledWindowEvalReceipts,
+        deterministic_runtime_total: deterministicRuntimeReceipts.length,
+        deterministic_runtime_truncated: deterministicRuntimeReceipts.length > sampledDeterministicRuntimeReceipts.length,
+        deterministic_runtime: sampledDeterministicRuntimeReceipts,
         set_range_value_total: rangeValueReceipts.length,
         set_range_value_truncated: rangeValueReceipts.length > sampledRangeValueReceipts.length,
         set_range_value: sampledRangeValueReceipts,
@@ -6188,6 +6281,111 @@ async function executeSetupAction(action, ordinal, viewport) {
       }
       return { ...base, ...setupScopeEvidence(scope), ok: true, storage, reload: action.reload === true };
     }
+    if (type === "deterministic_runtime") {
+      const scope = await setupActionScope(action, timeout);
+      if (!scope.ok) return setupScopeFailure(base, scope);
+      const randomQueue = Array.isArray(action.random_queue)
+        ? action.random_queue
+        : Array.isArray(action.randomQueue)
+          ? action.randomQueue
+          : null;
+      const now = setupFiniteNumber(action.now ?? action.date_now ?? action.dateNow ?? action.mock_now ?? action.mockNow ?? action.clock ?? action.timestamp ?? action.time_ms ?? action.timeMs);
+      const advanceMs = setupFiniteNumber(action.advance_ms ?? action.advanceMs ?? action.tick_ms ?? action.tickMs ?? action.add_ms ?? action.addMs);
+      const append = action.append === true || action.append_random === true || action.appendRandom === true;
+      const restore = action.restore === true || action.reset === true || action.restore_originals === true || action.restoreOriginals === true;
+      const runtimeResult = await scope.context.evaluate((payload) => {
+        const root = window;
+        const stateKey = "__RIDDLE_PROOF_DETERMINISTIC_RUNTIME__";
+        const state = root[stateKey] && typeof root[stateKey] === "object" && !Array.isArray(root[stateKey])
+          ? root[stateKey]
+          : {};
+        root[stateKey] = state;
+        if (typeof state.originalRandom !== "function") state.originalRandom = Math.random;
+        if (typeof state.originalDateNow !== "function") state.originalDateNow = Date.now;
+        const previousNow = typeof state.now === "number" && Number.isFinite(state.now)
+          ? state.now
+          : Date.now === state.originalDateNow
+            ? null
+            : Date.now();
+        if (payload.restore) {
+          Math.random = state.originalRandom;
+          Date.now = state.originalDateNow;
+          delete root[stateKey];
+          return {
+            ok: true,
+            restored: true,
+            random_enabled: false,
+            random_queue_added: 0,
+            random_queue_length: 0,
+            random_queue_mode: null,
+            random_underflow_count: typeof state.randomUnderflowCount === "number" ? state.randomUnderflowCount : 0,
+            clock_enabled: false,
+            previous_now: previousNow,
+            now: null,
+            advance_ms: null,
+          };
+        }
+        let randomQueueAdded = null;
+        let randomQueueMode = null;
+        if (Array.isArray(payload.random_queue)) {
+          const queue = payload.random_queue.filter((value) => typeof value === "number" && Number.isFinite(value) && value >= 0 && value < 1);
+          const existing = Array.isArray(state.randomQueue) ? state.randomQueue : [];
+          state.randomQueue = payload.append ? existing.concat(queue) : queue.slice();
+          randomQueueAdded = queue.length;
+          randomQueueMode = payload.append ? "append" : "replace";
+          Math.random = function riddleProofMockRandom() {
+            const activeQueue = Array.isArray(state.randomQueue) ? state.randomQueue : [];
+            if (activeQueue.length) return activeQueue.shift();
+            state.randomUnderflowCount = (typeof state.randomUnderflowCount === "number" ? state.randomUnderflowCount : 0) + 1;
+            return 0;
+          };
+        }
+        if (typeof payload.now === "number" && Number.isFinite(payload.now)) {
+          state.now = payload.now;
+          Date.now = function riddleProofMockDateNow() {
+            return state.now;
+          };
+        }
+        if (typeof payload.advance_ms === "number" && Number.isFinite(payload.advance_ms)) {
+          const baseNow = typeof state.now === "number" && Number.isFinite(state.now)
+            ? state.now
+            : Date.now();
+          state.now = baseNow + payload.advance_ms;
+          Date.now = function riddleProofMockDateNow() {
+            return state.now;
+          };
+        }
+        return {
+          ok: true,
+          restored: false,
+          random_enabled: Math.random !== state.originalRandom,
+          random_queue_added: randomQueueAdded,
+          random_queue_length: Array.isArray(state.randomQueue) ? state.randomQueue.length : 0,
+          random_queue_mode: randomQueueMode,
+          random_underflow_count: typeof state.randomUnderflowCount === "number" ? state.randomUnderflowCount : 0,
+          clock_enabled: Date.now !== state.originalDateNow,
+          previous_now: previousNow,
+          now: typeof state.now === "number" && Number.isFinite(state.now) ? state.now : null,
+          advance_ms: typeof payload.advance_ms === "number" && Number.isFinite(payload.advance_ms) ? payload.advance_ms : null,
+        };
+      }, { random_queue: randomQueue, now, advance_ms: advanceMs, append, restore });
+      return {
+        ...base,
+        ...setupScopeEvidence(scope),
+        ok: runtimeResult && runtimeResult.ok === true,
+        random_enabled: runtimeResult?.random_enabled,
+        random_queue_added: runtimeResult?.random_queue_added,
+        random_queue_length: runtimeResult?.random_queue_length,
+        random_queue_mode: runtimeResult?.random_queue_mode,
+        random_underflow_count: runtimeResult?.random_underflow_count,
+        clock_enabled: runtimeResult?.clock_enabled,
+        previous_now: runtimeResult?.previous_now,
+        now: runtimeResult?.now,
+        advance_ms: runtimeResult?.advance_ms,
+        restored: runtimeResult?.restored,
+        reason: runtimeResult && runtimeResult.ok === true ? undefined : runtimeResult?.reason || "deterministic_runtime_not_applied",
+      };
+    }
     if (type === "window_eval") {
       const script = String(action.script || action.code || action.source || action.body || "");
       const args = Array.isArray(action.args) ? action.args : [];

package/dist/profile.d.cts

@@ -5,7 +5,7 @@ declare const RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION: "riddle-proof.profile-evide
 declare const RIDDLE_PROOF_PROFILE_RESULT_VERSION: "riddle-proof.profile-result.v1";
 declare const RIDDLE_PROOF_PROFILE_STATUSES: readonly ["passed", "product_regression", "proof_insufficient", "environment_blocked", "configuration_error", "needs_human_review"];
 declare const RIDDLE_PROOF_PROFILE_CHECK_TYPES: readonly ["route_loaded", "url_search_param_equals", "url_search_param_absent", "selector_visible", "selector_absent", "selector_count_at_least", "selector_count_equals", "selector_count_equal", "selector_count_eq", "dialog_count_equals", "dialog_accept_count_equals", "dialog_dismiss_count_equals", "selector_text_visible", "selector_text_absent", "selector_text_order", "observe_within", "frame_text_visible", "frame_url_equals", "frame_url_matches", "frame_no_horizontal_overflow", "text_visible", "text_absent", "http_status", "link_status", "artifact_link_status", "route_inventory", "no_horizontal_overflow", "no_mobile_horizontal_overflow", "no_fatal_console_errors", "no_console_warnings"];
-declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "drag", "press", "fill", "set_input_value", "set_range_value", "canvas_signature", "assert_text_visible", "assert_text_absent", "assert_selector_count", "assert_window_value", "assert_window_number", "local_storage", "session_storage", "clear_storage", "clear_console", "dialog_response", "screenshot", "wait", "wait_for_selector", "wait_for_text", "window_eval", "window_call", "window_call_until"];
+declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "drag", "press", "fill", "set_input_value", "set_range_value", "deterministic_runtime", "canvas_signature", "assert_text_visible", "assert_text_absent", "assert_selector_count", "assert_window_value", "assert_window_number", "local_storage", "session_storage", "clear_storage", "clear_console", "dialog_response", "screenshot", "wait", "wait_for_selector", "wait_for_text", "window_eval", "window_call", "window_call_until"];
 type RiddleProofProfileStatus = typeof RIDDLE_PROOF_PROFILE_STATUSES[number];
 type RiddleProofProfileCheckType = typeof RIDDLE_PROOF_PROFILE_CHECK_TYPES[number];
 type RiddleProofProfileSetupActionType = typeof RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES[number];
@@ -126,6 +126,11 @@ interface RiddleProofProfileSetupAction {
     key?: string;
     value?: string;
     value_json?: JsonValue;
+    random_queue?: number[];
+    now?: number;
+    advance_ms?: number;
+    append?: boolean;
+    restore?: boolean;
     label?: string;
     script?: string;
     path?: string;

package/dist/profile.d.ts

@@ -5,7 +5,7 @@ declare const RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION: "riddle-proof.profile-evide
 declare const RIDDLE_PROOF_PROFILE_RESULT_VERSION: "riddle-proof.profile-result.v1";
 declare const RIDDLE_PROOF_PROFILE_STATUSES: readonly ["passed", "product_regression", "proof_insufficient", "environment_blocked", "configuration_error", "needs_human_review"];
 declare const RIDDLE_PROOF_PROFILE_CHECK_TYPES: readonly ["route_loaded", "url_search_param_equals", "url_search_param_absent", "selector_visible", "selector_absent", "selector_count_at_least", "selector_count_equals", "selector_count_equal", "selector_count_eq", "dialog_count_equals", "dialog_accept_count_equals", "dialog_dismiss_count_equals", "selector_text_visible", "selector_text_absent", "selector_text_order", "observe_within", "frame_text_visible", "frame_url_equals", "frame_url_matches", "frame_no_horizontal_overflow", "text_visible", "text_absent", "http_status", "link_status", "artifact_link_status", "route_inventory", "no_horizontal_overflow", "no_mobile_horizontal_overflow", "no_fatal_console_errors", "no_console_warnings"];
-declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "drag", "press", "fill", "set_input_value", "set_range_value", "canvas_signature", "assert_text_visible", "assert_text_absent", "assert_selector_count", "assert_window_value", "assert_window_number", "local_storage", "session_storage", "clear_storage", "clear_console", "dialog_response", "screenshot", "wait", "wait_for_selector", "wait_for_text", "window_eval", "window_call", "window_call_until"];
+declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "drag", "press", "fill", "set_input_value", "set_range_value", "deterministic_runtime", "canvas_signature", "assert_text_visible", "assert_text_absent", "assert_selector_count", "assert_window_value", "assert_window_number", "local_storage", "session_storage", "clear_storage", "clear_console", "dialog_response", "screenshot", "wait", "wait_for_selector", "wait_for_text", "window_eval", "window_call", "window_call_until"];
 type RiddleProofProfileStatus = typeof RIDDLE_PROOF_PROFILE_STATUSES[number];
 type RiddleProofProfileCheckType = typeof RIDDLE_PROOF_PROFILE_CHECK_TYPES[number];
 type RiddleProofProfileSetupActionType = typeof RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES[number];
@@ -126,6 +126,11 @@ interface RiddleProofProfileSetupAction {
     key?: string;
     value?: string;
     value_json?: JsonValue;
+    random_queue?: number[];
+    now?: number;
+    advance_ms?: number;
+    append?: boolean;
+    restore?: boolean;
     label?: string;
     script?: string;
     path?: string;

package/dist/profile.js

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