@riddledc/riddle-proof 0.7.55 → 0.7.57

package/README.md

@@ -174,6 +174,9 @@ riddle-proof-loop run-profile \
 Hosted profile runs emit Riddle poll progress to stderr while waiting. Use
 `--quiet` to suppress progress lines, or `--progress-every-ms` to tune the
 heartbeat cadence for long route-inventory or workflow profiles.
+Strict Riddle script validation remains on by default; use `--strict=false`
+only for trusted profile-generated scripts when the validator blocks a large
+workflow profile.
 
 The package includes a generic starter profile at
 `examples/profiles/page-content-basic.json`; copy that shape into a repository
@@ -239,7 +242,7 @@ 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`, `assert_window_value`,
-`local_storage`, `session_storage`, `clear_storage`, `wait`,
+`assert_window_number`, `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
@@ -253,6 +256,9 @@ 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.
+`assert_window_number` accepts `path` / `state_path` plus `expected_value`,
+`min_value`, or `max_value`, and is useful for canvas-only proof state such as
+distance, elapsed time, score, or retry counters.
 `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,

package/dist/{chunk-2JFDTCIC.js → chunk-H5LDZKGN.js}

@@ -38,6 +38,7 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "assert_text_absent",
   "assert_selector_count",
   "assert_window_value",
+  "assert_window_number",
   "local_storage",
   "session_storage",
   "clear_storage",
@@ -260,7 +261,7 @@ function normalizeSetupAction(input, index) {
     throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
   const path = stringFromOwn(input, "path", "function_path", "functionPath", "window_path", "windowPath", "state_path", "statePath");
-  if ((type === "window_call" || type === "assert_window_value") && !path) {
+  if ((type === "window_call" || type === "assert_window_value" || type === "assert_window_number") && !path) {
     throw new Error(`target.setup_actions[${index}] ${type} requires path.`);
   }
   const args = type === "window_call" ? normalizeSetupActionArgs(input, index) : void 0;
@@ -268,6 +269,17 @@ function normalizeSetupAction(input, index) {
   if (type === "assert_window_value" && !hasExpectedValue) {
     throw new Error(`target.setup_actions[${index}] ${type} requires expected_value.`);
   }
+  const rawExpectedValue = valueFromOwn(input, "expected_value", "expectedValue", "expected", "expect_value", "expectValue", "expect");
+  const minValue = numberValue(valueFromOwn(input, "min_value", "minValue", "minimum", "min", "at_least", "atLeast", "gte"));
+  const maxValue = numberValue(valueFromOwn(input, "max_value", "maxValue", "maximum", "max", "at_most", "atMost", "lte"));
+  if (type === "assert_window_number") {
+    if (!hasExpectedValue && minValue === void 0 && maxValue === void 0) {
+      throw new Error(`target.setup_actions[${index}] ${type} requires expected_value, min_value, or max_value.`);
+    }
+    if (hasExpectedValue && numberValue(rawExpectedValue) === void 0) {
+      throw new Error(`target.setup_actions[${index}] ${type} expected_value must be a finite number.`);
+    }
+  }
   const hasExpectedReturn = hasOwn(input, "expect_return") || hasOwn(input, "expectReturn") || hasOwn(input, "expected_return") || hasOwn(input, "expectedReturn");
   return {
     type,
@@ -279,7 +291,9 @@ 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,
+    expected_value: hasExpectedValue ? toJsonValue(rawExpectedValue) : void 0,
+    min_value: minValue,
+    max_value: maxValue,
     text: stringValue(input.text),
     pattern: stringValue(input.pattern),
     flags: stringValue(input.flags),
@@ -2103,6 +2117,10 @@ function setupNumber(value, fallback) {
   const number = Number(value);
   return Number.isFinite(number) && number >= 0 ? number : fallback;
 }
+function setupFiniteNumber(value) {
+  const number = Number(value);
+  return Number.isFinite(number) ? number : undefined;
+}
 function setupTextMatches(sample, action) {
   if (action.pattern) {
     try { return new RegExp(action.pattern, action.flags || "").test(sample || ""); } catch { return false; }
@@ -2448,6 +2466,58 @@ async function executeSetupAction(action, ordinal) {
         timeout_ms: timeout,
       };
     }
+    if (type === "assert_window_number") {
+      const path = String(action.path || action.window_path || action.windowPath || "");
+      const expected = setupFiniteNumber(action.expected_value ?? action.expectedValue ?? action.expected ?? action.expect_value ?? action.expectValue ?? action.expect);
+      const minValue = setupFiniteNumber(action.min_value ?? action.minValue ?? action.minimum ?? action.min ?? action.at_least ?? action.atLeast ?? action.gte);
+      const maxValue = setupFiniteNumber(action.max_value ?? action.maxValue ?? action.maximum ?? action.max ?? action.at_most ?? action.atMost ?? action.lte);
+      const hasExpected = expected !== undefined;
+      if (!path) return { ...base, path, reason: "missing_path" };
+      if (!hasExpected && minValue === undefined && maxValue === undefined) return { ...base, path, reason: "missing_number_expectation" };
+      const startedAt = Date.now();
+      let result = null;
+      let lastReason = "path_not_found";
+      while (Date.now() - startedAt <= timeout) {
+        result = await setupReadWindowValue(path);
+        if (result.ok) {
+          const actual = setupFiniteNumber(result.value);
+          if (actual === undefined) {
+            lastReason = "non_numeric_value";
+          } else if (hasExpected && actual !== expected) {
+            lastReason = "unexpected_number";
+          } else if (minValue !== undefined && actual < minValue) {
+            lastReason = "number_below_min";
+          } else if (maxValue !== undefined && actual > maxValue) {
+            lastReason = "number_above_max";
+          } else {
+            return {
+              ...base,
+              ok: true,
+              path,
+              value: actual,
+              expected_value: hasExpected ? expected : undefined,
+              min_value: minValue,
+              max_value: maxValue,
+              timeout_ms: timeout,
+            };
+          }
+        } else {
+          lastReason = result.reason || "path_not_found";
+        }
+        await page.waitForTimeout(100);
+      }
+      return {
+        ...base,
+        path,
+        reason: lastReason,
+        missing_part: result?.missing_part || undefined,
+        value: setupJsonValue(result?.value),
+        expected_value: hasExpected ? expected : undefined,
+        min_value: minValue,
+        max_value: maxValue,
+        timeout_ms: timeout,
+      };
+    }
     if (type === "click") {
       const locator = page.locator(action.selector);
       const count = await locator.count();

package/dist/cli.cjs

@@ -6911,6 +6911,7 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "assert_text_absent",
   "assert_selector_count",
   "assert_window_value",
+  "assert_window_number",
   "local_storage",
   "session_storage",
   "clear_storage",
@@ -7133,7 +7134,7 @@ function normalizeSetupAction(input, index) {
     throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
   const path7 = stringFromOwn(input, "path", "function_path", "functionPath", "window_path", "windowPath", "state_path", "statePath");
-  if ((type === "window_call" || type === "assert_window_value") && !path7) {
+  if ((type === "window_call" || type === "assert_window_value" || type === "assert_window_number") && !path7) {
     throw new Error(`target.setup_actions[${index}] ${type} requires path.`);
   }
   const args = type === "window_call" ? normalizeSetupActionArgs(input, index) : void 0;
@@ -7141,6 +7142,17 @@ function normalizeSetupAction(input, index) {
   if (type === "assert_window_value" && !hasExpectedValue) {
     throw new Error(`target.setup_actions[${index}] ${type} requires expected_value.`);
   }
+  const rawExpectedValue = valueFromOwn(input, "expected_value", "expectedValue", "expected", "expect_value", "expectValue", "expect");
+  const minValue = numberValue(valueFromOwn(input, "min_value", "minValue", "minimum", "min", "at_least", "atLeast", "gte"));
+  const maxValue = numberValue(valueFromOwn(input, "max_value", "maxValue", "maximum", "max", "at_most", "atMost", "lte"));
+  if (type === "assert_window_number") {
+    if (!hasExpectedValue && minValue === void 0 && maxValue === void 0) {
+      throw new Error(`target.setup_actions[${index}] ${type} requires expected_value, min_value, or max_value.`);
+    }
+    if (hasExpectedValue && numberValue(rawExpectedValue) === void 0) {
+      throw new Error(`target.setup_actions[${index}] ${type} expected_value must be a finite number.`);
+    }
+  }
   const hasExpectedReturn = hasOwn(input, "expect_return") || hasOwn(input, "expectReturn") || hasOwn(input, "expected_return") || hasOwn(input, "expectedReturn");
   return {
     type,
@@ -7152,7 +7164,9 @@ 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,
+    expected_value: hasExpectedValue ? toJsonValue(rawExpectedValue) : void 0,
+    min_value: minValue,
+    max_value: maxValue,
     text: stringValue2(input.text),
     pattern: stringValue2(input.pattern),
     flags: stringValue2(input.flags),
@@ -8960,6 +8974,10 @@ function setupNumber(value, fallback) {
   const number = Number(value);
   return Number.isFinite(number) && number >= 0 ? number : fallback;
 }
+function setupFiniteNumber(value) {
+  const number = Number(value);
+  return Number.isFinite(number) ? number : undefined;
+}
 function setupTextMatches(sample, action) {
   if (action.pattern) {
     try { return new RegExp(action.pattern, action.flags || "").test(sample || ""); } catch { return false; }
@@ -9305,6 +9323,58 @@ async function executeSetupAction(action, ordinal) {
         timeout_ms: timeout,
       };
     }
+    if (type === "assert_window_number") {
+      const path = String(action.path || action.window_path || action.windowPath || "");
+      const expected = setupFiniteNumber(action.expected_value ?? action.expectedValue ?? action.expected ?? action.expect_value ?? action.expectValue ?? action.expect);
+      const minValue = setupFiniteNumber(action.min_value ?? action.minValue ?? action.minimum ?? action.min ?? action.at_least ?? action.atLeast ?? action.gte);
+      const maxValue = setupFiniteNumber(action.max_value ?? action.maxValue ?? action.maximum ?? action.max ?? action.at_most ?? action.atMost ?? action.lte);
+      const hasExpected = expected !== undefined;
+      if (!path) return { ...base, path, reason: "missing_path" };
+      if (!hasExpected && minValue === undefined && maxValue === undefined) return { ...base, path, reason: "missing_number_expectation" };
+      const startedAt = Date.now();
+      let result = null;
+      let lastReason = "path_not_found";
+      while (Date.now() - startedAt <= timeout) {
+        result = await setupReadWindowValue(path);
+        if (result.ok) {
+          const actual = setupFiniteNumber(result.value);
+          if (actual === undefined) {
+            lastReason = "non_numeric_value";
+          } else if (hasExpected && actual !== expected) {
+            lastReason = "unexpected_number";
+          } else if (minValue !== undefined && actual < minValue) {
+            lastReason = "number_below_min";
+          } else if (maxValue !== undefined && actual > maxValue) {
+            lastReason = "number_above_max";
+          } else {
+            return {
+              ...base,
+              ok: true,
+              path,
+              value: actual,
+              expected_value: hasExpected ? expected : undefined,
+              min_value: minValue,
+              max_value: maxValue,
+              timeout_ms: timeout,
+            };
+          }
+        } else {
+          lastReason = result.reason || "path_not_found";
+        }
+        await page.waitForTimeout(100);
+      }
+      return {
+        ...base,
+        path,
+        reason: lastReason,
+        missing_part: result?.missing_part || undefined,
+        value: setupJsonValue(result?.value),
+        expected_value: hasExpected ? expected : undefined,
+        min_value: minValue,
+        max_value: maxValue,
+        timeout_ms: timeout,
+      };
+    }
     if (type === "click") {
       const locator = page.locator(action.selector);
       const count = await locator.count();
@@ -10276,7 +10346,7 @@ function usage() {
     "  riddle-proof-loop respond --state-path <path> --response-json <file|json|->",
     "  riddle-proof-loop respond --state-path <path> --decision <decision> --summary <text> [--payload-json <file|json|->]",
     "  riddle-proof-loop status --state-path <path>",
-    "  riddle-proof-loop run-profile --profile <file|json|-> --url <base-url> [--runner riddle] [--output <dir>] [--quiet]",
+    "  riddle-proof-loop run-profile --profile <file|json|-> --url <base-url> [--runner riddle] [--strict true|false] [--output <dir>] [--quiet]",
     "  riddle-proof-loop riddle-preview-deploy <build-dir> <label>",
     "  riddle-proof-loop riddle-server-preview <directory> --script-file <file> [--path /route] [--wait-for-selector selector]",
     "  riddle-proof-loop riddle-run-script --url <url> --script-file <file> [--viewport 1280x720] [--strict true|false]",
@@ -10634,6 +10704,7 @@ async function runProfileForCli(profile, options) {
         profile,
         optionString(options, "timeout") ? Number(optionString(options, "timeout")) : void 0
       ),
+      strict: optionBoolean(options, "strict"),
       sync: options.sync === true ? true : void 0
     });
   } catch (error) {

package/dist/cli.js

@@ -10,7 +10,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-2JFDTCIC.js";
+} from "./chunk-H5LDZKGN.js";
 import {
   createRiddleApiClient,
   parseRiddleViewport
@@ -44,7 +44,7 @@ function usage() {
     "  riddle-proof-loop respond --state-path <path> --response-json <file|json|->",
     "  riddle-proof-loop respond --state-path <path> --decision <decision> --summary <text> [--payload-json <file|json|->]",
     "  riddle-proof-loop status --state-path <path>",
-    "  riddle-proof-loop run-profile --profile <file|json|-> --url <base-url> [--runner riddle] [--output <dir>] [--quiet]",
+    "  riddle-proof-loop run-profile --profile <file|json|-> --url <base-url> [--runner riddle] [--strict true|false] [--output <dir>] [--quiet]",
     "  riddle-proof-loop riddle-preview-deploy <build-dir> <label>",
     "  riddle-proof-loop riddle-server-preview <directory> --script-file <file> [--path /route] [--wait-for-selector selector]",
     "  riddle-proof-loop riddle-run-script --url <url> --script-file <file> [--viewport 1280x720] [--strict true|false]",
@@ -402,6 +402,7 @@ async function runProfileForCli(profile, options) {
         profile,
         optionString(options, "timeout") ? Number(optionString(options, "timeout")) : void 0
       ),
+      strict: optionBoolean(options, "strict"),
       sync: options.sync === true ? true : void 0
     });
   } catch (error) {

package/dist/index.cjs

@@ -8752,6 +8752,7 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "assert_text_absent",
   "assert_selector_count",
   "assert_window_value",
+  "assert_window_number",
   "local_storage",
   "session_storage",
   "clear_storage",
@@ -8974,7 +8975,7 @@ function normalizeSetupAction(input, index) {
     throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
   const path6 = stringFromOwn(input, "path", "function_path", "functionPath", "window_path", "windowPath", "state_path", "statePath");
-  if ((type === "window_call" || type === "assert_window_value") && !path6) {
+  if ((type === "window_call" || type === "assert_window_value" || type === "assert_window_number") && !path6) {
     throw new Error(`target.setup_actions[${index}] ${type} requires path.`);
   }
   const args = type === "window_call" ? normalizeSetupActionArgs(input, index) : void 0;
@@ -8982,6 +8983,17 @@ function normalizeSetupAction(input, index) {
   if (type === "assert_window_value" && !hasExpectedValue) {
     throw new Error(`target.setup_actions[${index}] ${type} requires expected_value.`);
   }
+  const rawExpectedValue = valueFromOwn(input, "expected_value", "expectedValue", "expected", "expect_value", "expectValue", "expect");
+  const minValue = numberValue3(valueFromOwn(input, "min_value", "minValue", "minimum", "min", "at_least", "atLeast", "gte"));
+  const maxValue = numberValue3(valueFromOwn(input, "max_value", "maxValue", "maximum", "max", "at_most", "atMost", "lte"));
+  if (type === "assert_window_number") {
+    if (!hasExpectedValue && minValue === void 0 && maxValue === void 0) {
+      throw new Error(`target.setup_actions[${index}] ${type} requires expected_value, min_value, or max_value.`);
+    }
+    if (hasExpectedValue && numberValue3(rawExpectedValue) === void 0) {
+      throw new Error(`target.setup_actions[${index}] ${type} expected_value must be a finite number.`);
+    }
+  }
   const hasExpectedReturn = hasOwn(input, "expect_return") || hasOwn(input, "expectReturn") || hasOwn(input, "expected_return") || hasOwn(input, "expectedReturn");
   return {
     type,
@@ -8993,7 +9005,9 @@ 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,
+    expected_value: hasExpectedValue ? toJsonValue(rawExpectedValue) : void 0,
+    min_value: minValue,
+    max_value: maxValue,
     text: stringValue5(input.text),
     pattern: stringValue5(input.pattern),
     flags: stringValue5(input.flags),
@@ -10817,6 +10831,10 @@ function setupNumber(value, fallback) {
   const number = Number(value);
   return Number.isFinite(number) && number >= 0 ? number : fallback;
 }
+function setupFiniteNumber(value) {
+  const number = Number(value);
+  return Number.isFinite(number) ? number : undefined;
+}
 function setupTextMatches(sample, action) {
   if (action.pattern) {
     try { return new RegExp(action.pattern, action.flags || "").test(sample || ""); } catch { return false; }
@@ -11162,6 +11180,58 @@ async function executeSetupAction(action, ordinal) {
         timeout_ms: timeout,
       };
     }
+    if (type === "assert_window_number") {
+      const path = String(action.path || action.window_path || action.windowPath || "");
+      const expected = setupFiniteNumber(action.expected_value ?? action.expectedValue ?? action.expected ?? action.expect_value ?? action.expectValue ?? action.expect);
+      const minValue = setupFiniteNumber(action.min_value ?? action.minValue ?? action.minimum ?? action.min ?? action.at_least ?? action.atLeast ?? action.gte);
+      const maxValue = setupFiniteNumber(action.max_value ?? action.maxValue ?? action.maximum ?? action.max ?? action.at_most ?? action.atMost ?? action.lte);
+      const hasExpected = expected !== undefined;
+      if (!path) return { ...base, path, reason: "missing_path" };
+      if (!hasExpected && minValue === undefined && maxValue === undefined) return { ...base, path, reason: "missing_number_expectation" };
+      const startedAt = Date.now();
+      let result = null;
+      let lastReason = "path_not_found";
+      while (Date.now() - startedAt <= timeout) {
+        result = await setupReadWindowValue(path);
+        if (result.ok) {
+          const actual = setupFiniteNumber(result.value);
+          if (actual === undefined) {
+            lastReason = "non_numeric_value";
+          } else if (hasExpected && actual !== expected) {
+            lastReason = "unexpected_number";
+          } else if (minValue !== undefined && actual < minValue) {
+            lastReason = "number_below_min";
+          } else if (maxValue !== undefined && actual > maxValue) {
+            lastReason = "number_above_max";
+          } else {
+            return {
+              ...base,
+              ok: true,
+              path,
+              value: actual,
+              expected_value: hasExpected ? expected : undefined,
+              min_value: minValue,
+              max_value: maxValue,
+              timeout_ms: timeout,
+            };
+          }
+        } else {
+          lastReason = result.reason || "path_not_found";
+        }
+        await page.waitForTimeout(100);
+      }
+      return {
+        ...base,
+        path,
+        reason: lastReason,
+        missing_part: result?.missing_part || undefined,
+        value: setupJsonValue(result?.value),
+        expected_value: hasExpected ? expected : undefined,
+        min_value: minValue,
+        max_value: maxValue,
+        timeout_ms: timeout,
+      };
+    }
     if (type === "click") {
       const locator = page.locator(action.selector);
       const count = await locator.count();

package/dist/index.js

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

package/dist/profile.cjs

@@ -81,6 +81,7 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "assert_text_absent",
   "assert_selector_count",
   "assert_window_value",
+  "assert_window_number",
   "local_storage",
   "session_storage",
   "clear_storage",
@@ -303,7 +304,7 @@ function normalizeSetupAction(input, index) {
     throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
   const path = stringFromOwn(input, "path", "function_path", "functionPath", "window_path", "windowPath", "state_path", "statePath");
-  if ((type === "window_call" || type === "assert_window_value") && !path) {
+  if ((type === "window_call" || type === "assert_window_value" || type === "assert_window_number") && !path) {
     throw new Error(`target.setup_actions[${index}] ${type} requires path.`);
   }
   const args = type === "window_call" ? normalizeSetupActionArgs(input, index) : void 0;
@@ -311,6 +312,17 @@ function normalizeSetupAction(input, index) {
   if (type === "assert_window_value" && !hasExpectedValue) {
     throw new Error(`target.setup_actions[${index}] ${type} requires expected_value.`);
   }
+  const rawExpectedValue = valueFromOwn(input, "expected_value", "expectedValue", "expected", "expect_value", "expectValue", "expect");
+  const minValue = numberValue(valueFromOwn(input, "min_value", "minValue", "minimum", "min", "at_least", "atLeast", "gte"));
+  const maxValue = numberValue(valueFromOwn(input, "max_value", "maxValue", "maximum", "max", "at_most", "atMost", "lte"));
+  if (type === "assert_window_number") {
+    if (!hasExpectedValue && minValue === void 0 && maxValue === void 0) {
+      throw new Error(`target.setup_actions[${index}] ${type} requires expected_value, min_value, or max_value.`);
+    }
+    if (hasExpectedValue && numberValue(rawExpectedValue) === void 0) {
+      throw new Error(`target.setup_actions[${index}] ${type} expected_value must be a finite number.`);
+    }
+  }
   const hasExpectedReturn = hasOwn(input, "expect_return") || hasOwn(input, "expectReturn") || hasOwn(input, "expected_return") || hasOwn(input, "expectedReturn");
   return {
     type,
@@ -322,7 +334,9 @@ 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,
+    expected_value: hasExpectedValue ? toJsonValue(rawExpectedValue) : void 0,
+    min_value: minValue,
+    max_value: maxValue,
     text: stringValue(input.text),
     pattern: stringValue(input.pattern),
     flags: stringValue(input.flags),
@@ -2146,6 +2160,10 @@ function setupNumber(value, fallback) {
   const number = Number(value);
   return Number.isFinite(number) && number >= 0 ? number : fallback;
 }
+function setupFiniteNumber(value) {
+  const number = Number(value);
+  return Number.isFinite(number) ? number : undefined;
+}
 function setupTextMatches(sample, action) {
   if (action.pattern) {
     try { return new RegExp(action.pattern, action.flags || "").test(sample || ""); } catch { return false; }
@@ -2491,6 +2509,58 @@ async function executeSetupAction(action, ordinal) {
         timeout_ms: timeout,
       };
     }
+    if (type === "assert_window_number") {
+      const path = String(action.path || action.window_path || action.windowPath || "");
+      const expected = setupFiniteNumber(action.expected_value ?? action.expectedValue ?? action.expected ?? action.expect_value ?? action.expectValue ?? action.expect);
+      const minValue = setupFiniteNumber(action.min_value ?? action.minValue ?? action.minimum ?? action.min ?? action.at_least ?? action.atLeast ?? action.gte);
+      const maxValue = setupFiniteNumber(action.max_value ?? action.maxValue ?? action.maximum ?? action.max ?? action.at_most ?? action.atMost ?? action.lte);
+      const hasExpected = expected !== undefined;
+      if (!path) return { ...base, path, reason: "missing_path" };
+      if (!hasExpected && minValue === undefined && maxValue === undefined) return { ...base, path, reason: "missing_number_expectation" };
+      const startedAt = Date.now();
+      let result = null;
+      let lastReason = "path_not_found";
+      while (Date.now() - startedAt <= timeout) {
+        result = await setupReadWindowValue(path);
+        if (result.ok) {
+          const actual = setupFiniteNumber(result.value);
+          if (actual === undefined) {
+            lastReason = "non_numeric_value";
+          } else if (hasExpected && actual !== expected) {
+            lastReason = "unexpected_number";
+          } else if (minValue !== undefined && actual < minValue) {
+            lastReason = "number_below_min";
+          } else if (maxValue !== undefined && actual > maxValue) {
+            lastReason = "number_above_max";
+          } else {
+            return {
+              ...base,
+              ok: true,
+              path,
+              value: actual,
+              expected_value: hasExpected ? expected : undefined,
+              min_value: minValue,
+              max_value: maxValue,
+              timeout_ms: timeout,
+            };
+          }
+        } else {
+          lastReason = result.reason || "path_not_found";
+        }
+        await page.waitForTimeout(100);
+      }
+      return {
+        ...base,
+        path,
+        reason: lastReason,
+        missing_part: result?.missing_part || undefined,
+        value: setupJsonValue(result?.value),
+        expected_value: hasExpected ? expected : undefined,
+        min_value: minValue,
+        max_value: maxValue,
+        timeout_ms: timeout,
+      };
+    }
     if (type === "click") {
       const locator = page.locator(action.selector);
       const count = await locator.count();

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", "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", "assert_window_value", "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", "assert_window_number", "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];
@@ -28,6 +28,8 @@ interface RiddleProofProfileSetupAction {
     args?: JsonValue[];
     expect_return?: JsonValue;
     expected_value?: JsonValue;
+    min_value?: number;
+    max_value?: number;
     text?: string;
     pattern?: string;
     flags?: 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", "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", "assert_window_value", "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", "assert_window_number", "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];
@@ -28,6 +28,8 @@ interface RiddleProofProfileSetupAction {
     args?: JsonValue[];
     expect_return?: JsonValue;
     expected_value?: JsonValue;
+    min_value?: number;
+    max_value?: number;
     text?: string;
     pattern?: string;
     flags?: string;

package/dist/profile.js

@@ -19,7 +19,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-2JFDTCIC.js";
+} from "./chunk-H5LDZKGN.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.55",
+  "version": "0.7.57",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",