@riddledc/riddle-proof 0.7.51 → 0.7.53

package/README.md

@@ -238,23 +238,29 @@ where the second request must carry newer state.
 appears only after a picker, tab, login stub, storage seed, form fill,
 transport control, or other bounded interaction. Supported setup actions are
 `click`, `fill`, `set_input_value`, `assert_text_visible`,
-`assert_text_absent`, `assert_selector_count`, `local_storage`,
-`session_storage`, `clear_storage`, `wait`, `wait_for_selector`,
-`wait_for_text`, and `window_call`; a failed setup action is recorded as a failed
-`setup_actions_succeeded` check so the profile cannot pass without reaching
-the intended state. Text-matched `click` actions prefer visible matching
-elements, which keeps responsive layouts from selecting hidden desktop or
-mobile-only links. Add `force: true` to a click action only when the matched
-visible element is intentionally animated or otherwise never becomes stable
-enough for Playwright's default click actionability checks. Use setup
+`assert_text_absent`, `assert_selector_count`, `assert_window_value`,
+`local_storage`, `session_storage`, `clear_storage`, `wait`,
+`wait_for_selector`, `wait_for_text`, and `window_call`; a failed setup action
+is recorded as a failed `setup_actions_succeeded` check so the profile cannot
+pass without reaching the intended state. Text-matched `click` actions prefer
+visible matching elements, which keeps responsive layouts from selecting hidden
+desktop or mobile-only links. Add `force: true` to a click action only when the
+matched visible element is intentionally animated or otherwise never becomes
+stable enough for Playwright's default click actionability checks. Use setup
 assertions when the pre-click or pre-navigation state is part of the contract,
-for example a fresh row must be present, stale copy must be absent, or exactly
-one source link must exist before clicking into the final route.
-`assert_selector_count` accepts `expected_count`.
+for example a fresh row must be present, stale copy must be absent, exactly one
+source link must exist before clicking into the final route, or a canvas app's
+proof state must expose a terminal flag. `assert_selector_count` accepts
+`expected_count`; `assert_window_value` accepts `path` / `state_path` plus
+`expected_value` / `expected` and compares JSON-safe values exactly.
 `local_storage` and `session_storage` accept a `key` plus string `value` or
 JSON `json` / `value_json`, and can reload the page with `reload: true`.
 `clear_storage` clears `local`, `session`, or `both` browser storage scopes,
-defaults to `both`, and can also reload with `reload: true`.
+defaults to `both`, and can also reload with `reload: true`. Any setup action
+can include `repeat` / `repeat_count` / `times` from 1 to 100; each repetition
+is recorded with `repeat_index` and `repeat_count`, and `after_ms` runs after
+each repetition. Use it for bounded game proof helpers, retry controls, or other
+workflows where one declarative action needs to advance the app several times.
 
 `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-ZC4C52ZC.js → chunk-IKT7AKZN.js}

@@ -35,6 +35,7 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "assert_text_visible",
   "assert_text_absent",
   "assert_selector_count",
+  "assert_window_value",
   "local_storage",
   "session_storage",
   "clear_storage",
@@ -219,6 +220,14 @@ function normalizeSetupActionArgs(input, index) {
   }
   return argsInput.map(toJsonValue);
 }
+function normalizeSetupActionRepeat(input, index) {
+  const repeat = numberValue(valueFromOwn(input, "repeat", "repeat_count", "repeatCount", "times"));
+  if (repeat === void 0) return void 0;
+  if (!Number.isInteger(repeat) || repeat < 1 || repeat > 100) {
+    throw new Error(`target.setup_actions[${index}].repeat must be an integer from 1 to 100.`);
+  }
+  return repeat;
+}
 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);
@@ -248,11 +257,15 @@ function normalizeSetupAction(input, index) {
   if ((type === "local_storage" || type === "session_storage") && value === void 0 && !hasJsonValue) {
     throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
-  const path = stringFromOwn(input, "path", "function_path", "functionPath", "window_path", "windowPath");
-  if (type === "window_call" && !path) {
+  const path = stringFromOwn(input, "path", "function_path", "functionPath", "window_path", "windowPath", "state_path", "statePath");
+  if ((type === "window_call" || type === "assert_window_value") && !path) {
     throw new Error(`target.setup_actions[${index}] ${type} requires path.`);
   }
   const args = type === "window_call" ? normalizeSetupActionArgs(input, index) : void 0;
+  const hasExpectedValue = hasOwn(input, "expected_value") || hasOwn(input, "expectedValue") || hasOwn(input, "expected") || hasOwn(input, "expect_value") || hasOwn(input, "expectValue") || hasOwn(input, "expect");
+  if (type === "assert_window_value" && !hasExpectedValue) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires expected_value.`);
+  }
   const hasExpectedReturn = hasOwn(input, "expect_return") || hasOwn(input, "expectReturn") || hasOwn(input, "expected_return") || hasOwn(input, "expectedReturn");
   return {
     type,
@@ -264,6 +277,7 @@ function normalizeSetupAction(input, index) {
     path,
     args,
     expect_return: hasExpectedReturn ? toJsonValue(valueFromOwn(input, "expect_return", "expectReturn", "expected_return", "expectedReturn")) : void 0,
+    expected_value: hasExpectedValue ? toJsonValue(valueFromOwn(input, "expected_value", "expectedValue", "expected", "expect_value", "expectValue", "expect")) : void 0,
     text: stringValue(input.text),
     pattern: stringValue(input.pattern),
     flags: stringValue(input.flags),
@@ -272,6 +286,7 @@ function normalizeSetupAction(input, index) {
     ms: numberValue(input.ms) ?? numberValue(input.wait_ms) ?? numberValue(input.waitMs),
     timeout_ms: numberValue(input.timeout_ms) ?? numberValue(input.timeoutMs),
     after_ms: numberValue(input.after_ms) ?? numberValue(input.afterMs),
+    repeat: normalizeSetupActionRepeat(input, index),
     reload: input.reload === true,
     storage: normalizeSetupActionStorage(input.storage, index),
     continue_on_failure: input.continue_on_failure === true || input.continueOnFailure === true
@@ -1977,6 +1992,29 @@ function setupJsonValue(value) {
 function setupValuesEqual(left, right) {
   return JSON.stringify(setupJsonValue(left)) === JSON.stringify(setupJsonValue(right));
 }
+async function setupReadWindowValue(path) {
+  return await page.evaluate(({ path }) => {
+    const toJsonValue = (value) => {
+      if (value === null || value === undefined) return null;
+      if (typeof value === "string" || typeof value === "boolean") return value;
+      if (typeof value === "number") return Number.isFinite(value) ? value : null;
+      if (Array.isArray(value)) return value.map(toJsonValue);
+      if (typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, toJsonValue(child)]));
+      }
+      return String(value);
+    };
+    const pathParts = String(path || "").split(".").map((part) => part.trim()).filter(Boolean);
+    if (!pathParts.length) return { ok: false, reason: "missing_path" };
+    let current = window;
+    for (const part of pathParts) {
+      if (current === null || current === undefined) return { ok: false, reason: "path_not_found", missing_part: part };
+      current = current[part];
+      if (current === undefined) return { ok: false, reason: "path_not_found", missing_part: part };
+    }
+    return { ok: true, value: toJsonValue(current) };
+  }, { path });
+}
 async function setupLocatorText(locator, index) {
   return await locator.nth(index).textContent({ timeout: 1000 }).catch(() => "");
 }
@@ -2225,6 +2263,53 @@ async function executeSetupAction(action, ordinal) {
         error: result.error || undefined,
       };
     }
+    if (type === "assert_window_value") {
+      const path = String(action.path || action.window_path || action.windowPath || "");
+      const hasExpected = setupHasOwn(action, "expected_value")
+        || setupHasOwn(action, "expectedValue")
+        || setupHasOwn(action, "expected")
+        || setupHasOwn(action, "expect_value")
+        || setupHasOwn(action, "expectValue")
+        || setupHasOwn(action, "expect");
+      const expected = setupHasOwn(action, "expected_value")
+        ? action.expected_value
+        : setupHasOwn(action, "expectedValue")
+          ? action.expectedValue
+          : setupHasOwn(action, "expected")
+            ? action.expected
+            : setupHasOwn(action, "expect_value")
+              ? action.expect_value
+              : setupHasOwn(action, "expectValue")
+                ? action.expectValue
+                : action.expect;
+      if (!path) return { ...base, path, reason: "missing_path" };
+      if (!hasExpected) return { ...base, path, reason: "missing_expected_value" };
+      const startedAt = Date.now();
+      let result = null;
+      while (Date.now() - startedAt <= timeout) {
+        result = await setupReadWindowValue(path);
+        if (result.ok && setupValuesEqual(result.value, expected)) {
+          return {
+            ...base,
+            ok: true,
+            path,
+            value: setupJsonValue(result.value),
+            expected_value: setupJsonValue(expected),
+            timeout_ms: timeout,
+          };
+        }
+        await page.waitForTimeout(100);
+      }
+      return {
+        ...base,
+        path,
+        reason: result?.ok ? "unexpected_value" : result?.reason || "path_not_found",
+        missing_part: result?.missing_part || undefined,
+        value: setupJsonValue(result?.value),
+        expected_value: setupJsonValue(expected),
+        timeout_ms: timeout,
+      };
+    }
     if (type === "click") {
       const locator = page.locator(action.selector);
       const count = await locator.count();
@@ -2350,11 +2435,22 @@ async function executeSetupActions(actions) {
   const results = [];
   for (let index = 0; index < (actions || []).length; index += 1) {
     const action = actions[index] || {};
-    const result = await executeSetupAction(action, index);
-    results.push(result);
-    const afterMs = setupNumber(action.after_ms, 0);
-    if (afterMs) await page.waitForTimeout(afterMs);
-    if (result.ok === false && action.continue_on_failure !== true) break;
+    const requestedRepeat = setupNumber(action.repeat, 1);
+    const repeatCount = Math.min(100, Math.max(1, Math.floor(requestedRepeat || 1)));
+    let shouldStop = false;
+    for (let repeatIndex = 0; repeatIndex < repeatCount; repeatIndex += 1) {
+      const result = await executeSetupAction(action, index);
+      results.push(repeatCount > 1
+        ? { ...result, repeat_index: repeatIndex, repeat_count: repeatCount }
+        : result);
+      const afterMs = setupNumber(action.after_ms, 0);
+      if (afterMs) await page.waitForTimeout(afterMs);
+      if (result.ok === false && action.continue_on_failure !== true) {
+        shouldStop = true;
+        break;
+      }
+    }
+    if (shouldStop) break;
   }
   return results;
 }

package/dist/cli.cjs

@@ -6908,6 +6908,7 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "assert_text_visible",
   "assert_text_absent",
   "assert_selector_count",
+  "assert_window_value",
   "local_storage",
   "session_storage",
   "clear_storage",
@@ -7092,6 +7093,14 @@ function normalizeSetupActionArgs(input, index) {
   }
   return argsInput.map(toJsonValue);
 }
+function normalizeSetupActionRepeat(input, index) {
+  const repeat = numberValue(valueFromOwn(input, "repeat", "repeat_count", "repeatCount", "times"));
+  if (repeat === void 0) return void 0;
+  if (!Number.isInteger(repeat) || repeat < 1 || repeat > 100) {
+    throw new Error(`target.setup_actions[${index}].repeat must be an integer from 1 to 100.`);
+  }
+  return repeat;
+}
 function normalizeSetupAction(input, index) {
   if (!isRecord(input)) throw new Error(`target.setup_actions[${index}] must be an object.`);
   const type = normalizeSetupActionType(stringValue2(input.type), index);
@@ -7121,11 +7130,15 @@ function normalizeSetupAction(input, index) {
   if ((type === "local_storage" || type === "session_storage") && value === void 0 && !hasJsonValue) {
     throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
-  const path7 = stringFromOwn(input, "path", "function_path", "functionPath", "window_path", "windowPath");
-  if (type === "window_call" && !path7) {
+  const path7 = stringFromOwn(input, "path", "function_path", "functionPath", "window_path", "windowPath", "state_path", "statePath");
+  if ((type === "window_call" || type === "assert_window_value") && !path7) {
     throw new Error(`target.setup_actions[${index}] ${type} requires path.`);
   }
   const args = type === "window_call" ? normalizeSetupActionArgs(input, index) : void 0;
+  const hasExpectedValue = hasOwn(input, "expected_value") || hasOwn(input, "expectedValue") || hasOwn(input, "expected") || hasOwn(input, "expect_value") || hasOwn(input, "expectValue") || hasOwn(input, "expect");
+  if (type === "assert_window_value" && !hasExpectedValue) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires expected_value.`);
+  }
   const hasExpectedReturn = hasOwn(input, "expect_return") || hasOwn(input, "expectReturn") || hasOwn(input, "expected_return") || hasOwn(input, "expectedReturn");
   return {
     type,
@@ -7137,6 +7150,7 @@ function normalizeSetupAction(input, index) {
     path: path7,
     args,
     expect_return: hasExpectedReturn ? toJsonValue(valueFromOwn(input, "expect_return", "expectReturn", "expected_return", "expectedReturn")) : void 0,
+    expected_value: hasExpectedValue ? toJsonValue(valueFromOwn(input, "expected_value", "expectedValue", "expected", "expect_value", "expectValue", "expect")) : void 0,
     text: stringValue2(input.text),
     pattern: stringValue2(input.pattern),
     flags: stringValue2(input.flags),
@@ -7145,6 +7159,7 @@ function normalizeSetupAction(input, index) {
     ms: numberValue(input.ms) ?? numberValue(input.wait_ms) ?? numberValue(input.waitMs),
     timeout_ms: numberValue(input.timeout_ms) ?? numberValue(input.timeoutMs),
     after_ms: numberValue(input.after_ms) ?? numberValue(input.afterMs),
+    repeat: normalizeSetupActionRepeat(input, index),
     reload: input.reload === true,
     storage: normalizeSetupActionStorage(input.storage, index),
     continue_on_failure: input.continue_on_failure === true || input.continueOnFailure === true
@@ -8834,6 +8849,29 @@ function setupJsonValue(value) {
 function setupValuesEqual(left, right) {
   return JSON.stringify(setupJsonValue(left)) === JSON.stringify(setupJsonValue(right));
 }
+async function setupReadWindowValue(path) {
+  return await page.evaluate(({ path }) => {
+    const toJsonValue = (value) => {
+      if (value === null || value === undefined) return null;
+      if (typeof value === "string" || typeof value === "boolean") return value;
+      if (typeof value === "number") return Number.isFinite(value) ? value : null;
+      if (Array.isArray(value)) return value.map(toJsonValue);
+      if (typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, toJsonValue(child)]));
+      }
+      return String(value);
+    };
+    const pathParts = String(path || "").split(".").map((part) => part.trim()).filter(Boolean);
+    if (!pathParts.length) return { ok: false, reason: "missing_path" };
+    let current = window;
+    for (const part of pathParts) {
+      if (current === null || current === undefined) return { ok: false, reason: "path_not_found", missing_part: part };
+      current = current[part];
+      if (current === undefined) return { ok: false, reason: "path_not_found", missing_part: part };
+    }
+    return { ok: true, value: toJsonValue(current) };
+  }, { path });
+}
 async function setupLocatorText(locator, index) {
   return await locator.nth(index).textContent({ timeout: 1000 }).catch(() => "");
 }
@@ -9082,6 +9120,53 @@ async function executeSetupAction(action, ordinal) {
         error: result.error || undefined,
       };
     }
+    if (type === "assert_window_value") {
+      const path = String(action.path || action.window_path || action.windowPath || "");
+      const hasExpected = setupHasOwn(action, "expected_value")
+        || setupHasOwn(action, "expectedValue")
+        || setupHasOwn(action, "expected")
+        || setupHasOwn(action, "expect_value")
+        || setupHasOwn(action, "expectValue")
+        || setupHasOwn(action, "expect");
+      const expected = setupHasOwn(action, "expected_value")
+        ? action.expected_value
+        : setupHasOwn(action, "expectedValue")
+          ? action.expectedValue
+          : setupHasOwn(action, "expected")
+            ? action.expected
+            : setupHasOwn(action, "expect_value")
+              ? action.expect_value
+              : setupHasOwn(action, "expectValue")
+                ? action.expectValue
+                : action.expect;
+      if (!path) return { ...base, path, reason: "missing_path" };
+      if (!hasExpected) return { ...base, path, reason: "missing_expected_value" };
+      const startedAt = Date.now();
+      let result = null;
+      while (Date.now() - startedAt <= timeout) {
+        result = await setupReadWindowValue(path);
+        if (result.ok && setupValuesEqual(result.value, expected)) {
+          return {
+            ...base,
+            ok: true,
+            path,
+            value: setupJsonValue(result.value),
+            expected_value: setupJsonValue(expected),
+            timeout_ms: timeout,
+          };
+        }
+        await page.waitForTimeout(100);
+      }
+      return {
+        ...base,
+        path,
+        reason: result?.ok ? "unexpected_value" : result?.reason || "path_not_found",
+        missing_part: result?.missing_part || undefined,
+        value: setupJsonValue(result?.value),
+        expected_value: setupJsonValue(expected),
+        timeout_ms: timeout,
+      };
+    }
     if (type === "click") {
       const locator = page.locator(action.selector);
       const count = await locator.count();
@@ -9207,11 +9292,22 @@ async function executeSetupActions(actions) {
   const results = [];
   for (let index = 0; index < (actions || []).length; index += 1) {
     const action = actions[index] || {};
-    const result = await executeSetupAction(action, index);
-    results.push(result);
-    const afterMs = setupNumber(action.after_ms, 0);
-    if (afterMs) await page.waitForTimeout(afterMs);
-    if (result.ok === false && action.continue_on_failure !== true) break;
+    const requestedRepeat = setupNumber(action.repeat, 1);
+    const repeatCount = Math.min(100, Math.max(1, Math.floor(requestedRepeat || 1)));
+    let shouldStop = false;
+    for (let repeatIndex = 0; repeatIndex < repeatCount; repeatIndex += 1) {
+      const result = await executeSetupAction(action, index);
+      results.push(repeatCount > 1
+        ? { ...result, repeat_index: repeatIndex, repeat_count: repeatCount }
+        : result);
+      const afterMs = setupNumber(action.after_ms, 0);
+      if (afterMs) await page.waitForTimeout(afterMs);
+      if (result.ok === false && action.continue_on_failure !== true) {
+        shouldStop = true;
+        break;
+      }
+    }
+    if (shouldStop) break;
   }
   return results;
 }

package/dist/cli.js

@@ -10,7 +10,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-ZC4C52ZC.js";
+} from "./chunk-IKT7AKZN.js";
 import {
   createRiddleApiClient,
   parseRiddleViewport

package/dist/index.cjs

@@ -8749,6 +8749,7 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "assert_text_visible",
   "assert_text_absent",
   "assert_selector_count",
+  "assert_window_value",
   "local_storage",
   "session_storage",
   "clear_storage",
@@ -8933,6 +8934,14 @@ function normalizeSetupActionArgs(input, index) {
   }
   return argsInput.map(toJsonValue);
 }
+function normalizeSetupActionRepeat(input, index) {
+  const repeat = numberValue3(valueFromOwn(input, "repeat", "repeat_count", "repeatCount", "times"));
+  if (repeat === void 0) return void 0;
+  if (!Number.isInteger(repeat) || repeat < 1 || repeat > 100) {
+    throw new Error(`target.setup_actions[${index}].repeat must be an integer from 1 to 100.`);
+  }
+  return repeat;
+}
 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);
@@ -8962,11 +8971,15 @@ function normalizeSetupAction(input, index) {
   if ((type === "local_storage" || type === "session_storage") && value === void 0 && !hasJsonValue) {
     throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
-  const path6 = stringFromOwn(input, "path", "function_path", "functionPath", "window_path", "windowPath");
-  if (type === "window_call" && !path6) {
+  const path6 = stringFromOwn(input, "path", "function_path", "functionPath", "window_path", "windowPath", "state_path", "statePath");
+  if ((type === "window_call" || type === "assert_window_value") && !path6) {
     throw new Error(`target.setup_actions[${index}] ${type} requires path.`);
   }
   const args = type === "window_call" ? normalizeSetupActionArgs(input, index) : void 0;
+  const hasExpectedValue = hasOwn(input, "expected_value") || hasOwn(input, "expectedValue") || hasOwn(input, "expected") || hasOwn(input, "expect_value") || hasOwn(input, "expectValue") || hasOwn(input, "expect");
+  if (type === "assert_window_value" && !hasExpectedValue) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires expected_value.`);
+  }
   const hasExpectedReturn = hasOwn(input, "expect_return") || hasOwn(input, "expectReturn") || hasOwn(input, "expected_return") || hasOwn(input, "expectedReturn");
   return {
     type,
@@ -8978,6 +8991,7 @@ function normalizeSetupAction(input, index) {
     path: path6,
     args,
     expect_return: hasExpectedReturn ? toJsonValue(valueFromOwn(input, "expect_return", "expectReturn", "expected_return", "expectedReturn")) : void 0,
+    expected_value: hasExpectedValue ? toJsonValue(valueFromOwn(input, "expected_value", "expectedValue", "expected", "expect_value", "expectValue", "expect")) : void 0,
     text: stringValue5(input.text),
     pattern: stringValue5(input.pattern),
     flags: stringValue5(input.flags),
@@ -8986,6 +9000,7 @@ function normalizeSetupAction(input, index) {
     ms: numberValue3(input.ms) ?? numberValue3(input.wait_ms) ?? numberValue3(input.waitMs),
     timeout_ms: numberValue3(input.timeout_ms) ?? numberValue3(input.timeoutMs),
     after_ms: numberValue3(input.after_ms) ?? numberValue3(input.afterMs),
+    repeat: normalizeSetupActionRepeat(input, index),
     reload: input.reload === true,
     storage: normalizeSetupActionStorage(input.storage, index),
     continue_on_failure: input.continue_on_failure === true || input.continueOnFailure === true
@@ -10691,6 +10706,29 @@ function setupJsonValue(value) {
 function setupValuesEqual(left, right) {
   return JSON.stringify(setupJsonValue(left)) === JSON.stringify(setupJsonValue(right));
 }
+async function setupReadWindowValue(path) {
+  return await page.evaluate(({ path }) => {
+    const toJsonValue = (value) => {
+      if (value === null || value === undefined) return null;
+      if (typeof value === "string" || typeof value === "boolean") return value;
+      if (typeof value === "number") return Number.isFinite(value) ? value : null;
+      if (Array.isArray(value)) return value.map(toJsonValue);
+      if (typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, toJsonValue(child)]));
+      }
+      return String(value);
+    };
+    const pathParts = String(path || "").split(".").map((part) => part.trim()).filter(Boolean);
+    if (!pathParts.length) return { ok: false, reason: "missing_path" };
+    let current = window;
+    for (const part of pathParts) {
+      if (current === null || current === undefined) return { ok: false, reason: "path_not_found", missing_part: part };
+      current = current[part];
+      if (current === undefined) return { ok: false, reason: "path_not_found", missing_part: part };
+    }
+    return { ok: true, value: toJsonValue(current) };
+  }, { path });
+}
 async function setupLocatorText(locator, index) {
   return await locator.nth(index).textContent({ timeout: 1000 }).catch(() => "");
 }
@@ -10939,6 +10977,53 @@ async function executeSetupAction(action, ordinal) {
         error: result.error || undefined,
       };
     }
+    if (type === "assert_window_value") {
+      const path = String(action.path || action.window_path || action.windowPath || "");
+      const hasExpected = setupHasOwn(action, "expected_value")
+        || setupHasOwn(action, "expectedValue")
+        || setupHasOwn(action, "expected")
+        || setupHasOwn(action, "expect_value")
+        || setupHasOwn(action, "expectValue")
+        || setupHasOwn(action, "expect");
+      const expected = setupHasOwn(action, "expected_value")
+        ? action.expected_value
+        : setupHasOwn(action, "expectedValue")
+          ? action.expectedValue
+          : setupHasOwn(action, "expected")
+            ? action.expected
+            : setupHasOwn(action, "expect_value")
+              ? action.expect_value
+              : setupHasOwn(action, "expectValue")
+                ? action.expectValue
+                : action.expect;
+      if (!path) return { ...base, path, reason: "missing_path" };
+      if (!hasExpected) return { ...base, path, reason: "missing_expected_value" };
+      const startedAt = Date.now();
+      let result = null;
+      while (Date.now() - startedAt <= timeout) {
+        result = await setupReadWindowValue(path);
+        if (result.ok && setupValuesEqual(result.value, expected)) {
+          return {
+            ...base,
+            ok: true,
+            path,
+            value: setupJsonValue(result.value),
+            expected_value: setupJsonValue(expected),
+            timeout_ms: timeout,
+          };
+        }
+        await page.waitForTimeout(100);
+      }
+      return {
+        ...base,
+        path,
+        reason: result?.ok ? "unexpected_value" : result?.reason || "path_not_found",
+        missing_part: result?.missing_part || undefined,
+        value: setupJsonValue(result?.value),
+        expected_value: setupJsonValue(expected),
+        timeout_ms: timeout,
+      };
+    }
     if (type === "click") {
       const locator = page.locator(action.selector);
       const count = await locator.count();
@@ -11064,11 +11149,22 @@ async function executeSetupActions(actions) {
   const results = [];
   for (let index = 0; index < (actions || []).length; index += 1) {
     const action = actions[index] || {};
-    const result = await executeSetupAction(action, index);
-    results.push(result);
-    const afterMs = setupNumber(action.after_ms, 0);
-    if (afterMs) await page.waitForTimeout(afterMs);
-    if (result.ok === false && action.continue_on_failure !== true) break;
+    const requestedRepeat = setupNumber(action.repeat, 1);
+    const repeatCount = Math.min(100, Math.max(1, Math.floor(requestedRepeat || 1)));
+    let shouldStop = false;
+    for (let repeatIndex = 0; repeatIndex < repeatCount; repeatIndex += 1) {
+      const result = await executeSetupAction(action, index);
+      results.push(repeatCount > 1
+        ? { ...result, repeat_index: repeatIndex, repeat_count: repeatCount }
+        : result);
+      const afterMs = setupNumber(action.after_ms, 0);
+      if (afterMs) await page.waitForTimeout(afterMs);
+      if (result.ok === false && action.continue_on_failure !== true) {
+        shouldStop = true;
+        break;
+      }
+    }
+    if (shouldStop) break;
   }
   return results;
 }

package/dist/index.js

@@ -58,7 +58,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-ZC4C52ZC.js";
+} from "./chunk-IKT7AKZN.js";
 import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,

package/dist/profile.cjs

@@ -78,6 +78,7 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "assert_text_visible",
   "assert_text_absent",
   "assert_selector_count",
+  "assert_window_value",
   "local_storage",
   "session_storage",
   "clear_storage",
@@ -262,6 +263,14 @@ function normalizeSetupActionArgs(input, index) {
   }
   return argsInput.map(toJsonValue);
 }
+function normalizeSetupActionRepeat(input, index) {
+  const repeat = numberValue(valueFromOwn(input, "repeat", "repeat_count", "repeatCount", "times"));
+  if (repeat === void 0) return void 0;
+  if (!Number.isInteger(repeat) || repeat < 1 || repeat > 100) {
+    throw new Error(`target.setup_actions[${index}].repeat must be an integer from 1 to 100.`);
+  }
+  return repeat;
+}
 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);
@@ -291,11 +300,15 @@ function normalizeSetupAction(input, index) {
   if ((type === "local_storage" || type === "session_storage") && value === void 0 && !hasJsonValue) {
     throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
-  const path = stringFromOwn(input, "path", "function_path", "functionPath", "window_path", "windowPath");
-  if (type === "window_call" && !path) {
+  const path = stringFromOwn(input, "path", "function_path", "functionPath", "window_path", "windowPath", "state_path", "statePath");
+  if ((type === "window_call" || type === "assert_window_value") && !path) {
     throw new Error(`target.setup_actions[${index}] ${type} requires path.`);
   }
   const args = type === "window_call" ? normalizeSetupActionArgs(input, index) : void 0;
+  const hasExpectedValue = hasOwn(input, "expected_value") || hasOwn(input, "expectedValue") || hasOwn(input, "expected") || hasOwn(input, "expect_value") || hasOwn(input, "expectValue") || hasOwn(input, "expect");
+  if (type === "assert_window_value" && !hasExpectedValue) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires expected_value.`);
+  }
   const hasExpectedReturn = hasOwn(input, "expect_return") || hasOwn(input, "expectReturn") || hasOwn(input, "expected_return") || hasOwn(input, "expectedReturn");
   return {
     type,
@@ -307,6 +320,7 @@ function normalizeSetupAction(input, index) {
     path,
     args,
     expect_return: hasExpectedReturn ? toJsonValue(valueFromOwn(input, "expect_return", "expectReturn", "expected_return", "expectedReturn")) : void 0,
+    expected_value: hasExpectedValue ? toJsonValue(valueFromOwn(input, "expected_value", "expectedValue", "expected", "expect_value", "expectValue", "expect")) : void 0,
     text: stringValue(input.text),
     pattern: stringValue(input.pattern),
     flags: stringValue(input.flags),
@@ -315,6 +329,7 @@ function normalizeSetupAction(input, index) {
     ms: numberValue(input.ms) ?? numberValue(input.wait_ms) ?? numberValue(input.waitMs),
     timeout_ms: numberValue(input.timeout_ms) ?? numberValue(input.timeoutMs),
     after_ms: numberValue(input.after_ms) ?? numberValue(input.afterMs),
+    repeat: normalizeSetupActionRepeat(input, index),
     reload: input.reload === true,
     storage: normalizeSetupActionStorage(input.storage, index),
     continue_on_failure: input.continue_on_failure === true || input.continueOnFailure === true
@@ -2020,6 +2035,29 @@ function setupJsonValue(value) {
 function setupValuesEqual(left, right) {
   return JSON.stringify(setupJsonValue(left)) === JSON.stringify(setupJsonValue(right));
 }
+async function setupReadWindowValue(path) {
+  return await page.evaluate(({ path }) => {
+    const toJsonValue = (value) => {
+      if (value === null || value === undefined) return null;
+      if (typeof value === "string" || typeof value === "boolean") return value;
+      if (typeof value === "number") return Number.isFinite(value) ? value : null;
+      if (Array.isArray(value)) return value.map(toJsonValue);
+      if (typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, toJsonValue(child)]));
+      }
+      return String(value);
+    };
+    const pathParts = String(path || "").split(".").map((part) => part.trim()).filter(Boolean);
+    if (!pathParts.length) return { ok: false, reason: "missing_path" };
+    let current = window;
+    for (const part of pathParts) {
+      if (current === null || current === undefined) return { ok: false, reason: "path_not_found", missing_part: part };
+      current = current[part];
+      if (current === undefined) return { ok: false, reason: "path_not_found", missing_part: part };
+    }
+    return { ok: true, value: toJsonValue(current) };
+  }, { path });
+}
 async function setupLocatorText(locator, index) {
   return await locator.nth(index).textContent({ timeout: 1000 }).catch(() => "");
 }
@@ -2268,6 +2306,53 @@ async function executeSetupAction(action, ordinal) {
         error: result.error || undefined,
       };
     }
+    if (type === "assert_window_value") {
+      const path = String(action.path || action.window_path || action.windowPath || "");
+      const hasExpected = setupHasOwn(action, "expected_value")
+        || setupHasOwn(action, "expectedValue")
+        || setupHasOwn(action, "expected")
+        || setupHasOwn(action, "expect_value")
+        || setupHasOwn(action, "expectValue")
+        || setupHasOwn(action, "expect");
+      const expected = setupHasOwn(action, "expected_value")
+        ? action.expected_value
+        : setupHasOwn(action, "expectedValue")
+          ? action.expectedValue
+          : setupHasOwn(action, "expected")
+            ? action.expected
+            : setupHasOwn(action, "expect_value")
+              ? action.expect_value
+              : setupHasOwn(action, "expectValue")
+                ? action.expectValue
+                : action.expect;
+      if (!path) return { ...base, path, reason: "missing_path" };
+      if (!hasExpected) return { ...base, path, reason: "missing_expected_value" };
+      const startedAt = Date.now();
+      let result = null;
+      while (Date.now() - startedAt <= timeout) {
+        result = await setupReadWindowValue(path);
+        if (result.ok && setupValuesEqual(result.value, expected)) {
+          return {
+            ...base,
+            ok: true,
+            path,
+            value: setupJsonValue(result.value),
+            expected_value: setupJsonValue(expected),
+            timeout_ms: timeout,
+          };
+        }
+        await page.waitForTimeout(100);
+      }
+      return {
+        ...base,
+        path,
+        reason: result?.ok ? "unexpected_value" : result?.reason || "path_not_found",
+        missing_part: result?.missing_part || undefined,
+        value: setupJsonValue(result?.value),
+        expected_value: setupJsonValue(expected),
+        timeout_ms: timeout,
+      };
+    }
     if (type === "click") {
       const locator = page.locator(action.selector);
       const count = await locator.count();
@@ -2393,11 +2478,22 @@ async function executeSetupActions(actions) {
   const results = [];
   for (let index = 0; index < (actions || []).length; index += 1) {
     const action = actions[index] || {};
-    const result = await executeSetupAction(action, index);
-    results.push(result);
-    const afterMs = setupNumber(action.after_ms, 0);
-    if (afterMs) await page.waitForTimeout(afterMs);
-    if (result.ok === false && action.continue_on_failure !== true) break;
+    const requestedRepeat = setupNumber(action.repeat, 1);
+    const repeatCount = Math.min(100, Math.max(1, Math.floor(requestedRepeat || 1)));
+    let shouldStop = false;
+    for (let repeatIndex = 0; repeatIndex < repeatCount; repeatIndex += 1) {
+      const result = await executeSetupAction(action, index);
+      results.push(repeatCount > 1
+        ? { ...result, repeat_index: repeatIndex, repeat_count: repeatCount }
+        : result);
+      const afterMs = setupNumber(action.after_ms, 0);
+      if (afterMs) await page.waitForTimeout(afterMs);
+      if (result.ok === false && action.continue_on_failure !== true) {
+        shouldStop = true;
+        break;
+      }
+    }
+    if (shouldStop) break;
   }
   return results;
 }

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", "selector_visible", "selector_absent", "selector_count_at_least", "selector_count_equals", "selector_count_equal", "selector_count_eq", "selector_text_order", "frame_text_visible", "frame_no_horizontal_overflow", "text_visible", "text_absent", "route_inventory", "no_horizontal_overflow", "no_mobile_horizontal_overflow", "no_fatal_console_errors"];
-declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "fill", "set_input_value", "assert_text_visible", "assert_text_absent", "assert_selector_count", "local_storage", "session_storage", "clear_storage", "wait", "wait_for_selector", "wait_for_text", "window_call"];
+declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "fill", "set_input_value", "assert_text_visible", "assert_text_absent", "assert_selector_count", "assert_window_value", "local_storage", "session_storage", "clear_storage", "wait", "wait_for_selector", "wait_for_text", "window_call"];
 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];
@@ -27,6 +27,7 @@ interface RiddleProofProfileSetupAction {
     path?: string;
     args?: JsonValue[];
     expect_return?: JsonValue;
+    expected_value?: JsonValue;
     text?: string;
     pattern?: string;
     flags?: string;
@@ -35,6 +36,7 @@ interface RiddleProofProfileSetupAction {
     ms?: number;
     timeout_ms?: number;
     after_ms?: number;
+    repeat?: number;
     reload?: boolean;
     storage?: "local" | "session" | "both";
     continue_on_failure?: boolean;

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", "selector_visible", "selector_absent", "selector_count_at_least", "selector_count_equals", "selector_count_equal", "selector_count_eq", "selector_text_order", "frame_text_visible", "frame_no_horizontal_overflow", "text_visible", "text_absent", "route_inventory", "no_horizontal_overflow", "no_mobile_horizontal_overflow", "no_fatal_console_errors"];
-declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "fill", "set_input_value", "assert_text_visible", "assert_text_absent", "assert_selector_count", "local_storage", "session_storage", "clear_storage", "wait", "wait_for_selector", "wait_for_text", "window_call"];
+declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "fill", "set_input_value", "assert_text_visible", "assert_text_absent", "assert_selector_count", "assert_window_value", "local_storage", "session_storage", "clear_storage", "wait", "wait_for_selector", "wait_for_text", "window_call"];
 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];
@@ -27,6 +27,7 @@ interface RiddleProofProfileSetupAction {
     path?: string;
     args?: JsonValue[];
     expect_return?: JsonValue;
+    expected_value?: JsonValue;
     text?: string;
     pattern?: string;
     flags?: string;
@@ -35,6 +36,7 @@ interface RiddleProofProfileSetupAction {
     ms?: number;
     timeout_ms?: number;
     after_ms?: number;
+    repeat?: number;
     reload?: boolean;
     storage?: "local" | "session" | "both";
     continue_on_failure?: boolean;

package/dist/profile.js

@@ -19,7 +19,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-ZC4C52ZC.js";
+} from "./chunk-IKT7AKZN.js";
 export {
   RIDDLE_PROOF_PROFILE_CHECK_TYPES,
   RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,

package/dist/proof-run-engine.d.cts

@@ -292,7 +292,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     blocking?: boolean;
     details?: Record<string, unknown>;
     ok: boolean;
-    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
     state_path: string;
     stage: any;
     summary: string;
@@ -382,7 +382,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     continueWithStage?: WorkflowStage | null;
     blocking?: boolean;
     details?: Record<string, unknown>;
-    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
     state_path: string;
     stage: any;
     checkpoint: string;
@@ -659,7 +659,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     error?: undefined;
 } | {
     ok: boolean;
-    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
     state_path: string;
     stage: any;
     summary: string;

package/dist/proof-run-engine.d.ts

@@ -292,7 +292,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     blocking?: boolean;
     details?: Record<string, unknown>;
     ok: boolean;
-    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
     state_path: string;
     stage: any;
     summary: string;
@@ -382,7 +382,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     continueWithStage?: WorkflowStage | null;
     blocking?: boolean;
     details?: Record<string, unknown>;
-    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
     state_path: string;
     stage: any;
     checkpoint: string;
@@ -659,7 +659,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     error?: undefined;
 } | {
     ok: boolean;
-    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
     state_path: string;
     stage: any;
     summary: string;

package/package.json

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