@riddledc/riddle-proof 0.7.56 → 0.7.58

package/README.md

@@ -240,22 +240,28 @@ where the second request must carry newer state.
 `target.setup_actions` is optional. Use it when the meaningful proof surface
 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`,
+`click`, `press`, `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
 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,
+stable enough for Playwright's default click actionability checks. Use `press`
+with a Playwright key name, such as `Enter`, `Space`, or `ArrowLeft`,
+when a route's intended browser control is keyboard-driven; omit `selector` for
+a page-level key press, or provide `selector` to press against a focused element.
+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, 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.
+`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-7ZBK2GQX.js}

@@ -32,12 +32,14 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
 ];
 var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "click",
+  "press",
   "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",
@@ -200,7 +202,7 @@ function isSupportedCheckType(value) {
 }
 function normalizeSetupActionType(value, index) {
   const normalizedInput = String(value || "").trim().replace(/-/g, "_");
-  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput;
+  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput;
   if (RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.includes(normalized)) {
     return normalized;
   }
@@ -253,6 +255,9 @@ function normalizeSetupAction(input, index) {
     throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
   const key = stringValue(input.key);
+  if (type === "press" && !key) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires key.`);
+  }
   if ((type === "local_storage" || type === "session_storage") && !key) {
     throw new Error(`target.setup_actions[${index}] ${type} requires key.`);
   }
@@ -260,7 +265,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 +273,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 +295,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 +2121,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; }
@@ -2326,6 +2348,21 @@ async function executeSetupAction(action, ordinal) {
       await page.waitForSelector(action.selector, { state: "visible", timeout });
       return { ...base, ok: true, timeout_ms: timeout };
     }
+    if (type === "press") {
+      const key = String(action.key || "").trim();
+      if (!key) return { ...base, reason: "missing_key" };
+      if (!action.selector) {
+        await page.keyboard.press(key);
+        return { ...base, ok: true, key };
+      }
+      const locator = page.locator(action.selector);
+      const count = await locator.count();
+      if (!count) return { ...base, reason: "selector_not_found", count, key };
+      const targetIndex = Number.isInteger(action.index) ? action.index : 0;
+      if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex, key };
+      await locator.nth(targetIndex).press(key, { timeout });
+      return { ...base, ok: true, count, target_index: targetIndex, key };
+    }
     if (type === "local_storage" || type === "session_storage") {
       const value = setupActionValue(action);
       await page.evaluate(({ type, key, value }) => {
@@ -2448,6 +2485,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

@@ -6905,12 +6905,14 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
 ];
 var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "click",
+  "press",
   "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",
@@ -7073,7 +7075,7 @@ function isSupportedCheckType(value) {
 }
 function normalizeSetupActionType(value, index) {
   const normalizedInput = String(value || "").trim().replace(/-/g, "_");
-  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput;
+  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput;
   if (RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.includes(normalized)) {
     return normalized;
   }
@@ -7126,6 +7128,9 @@ function normalizeSetupAction(input, index) {
     throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
   const key = stringValue2(input.key);
+  if (type === "press" && !key) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires key.`);
+  }
   if ((type === "local_storage" || type === "session_storage") && !key) {
     throw new Error(`target.setup_actions[${index}] ${type} requires key.`);
   }
@@ -7133,7 +7138,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 +7146,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 +7168,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 +8978,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; }
@@ -9183,6 +9205,21 @@ async function executeSetupAction(action, ordinal) {
       await page.waitForSelector(action.selector, { state: "visible", timeout });
       return { ...base, ok: true, timeout_ms: timeout };
     }
+    if (type === "press") {
+      const key = String(action.key || "").trim();
+      if (!key) return { ...base, reason: "missing_key" };
+      if (!action.selector) {
+        await page.keyboard.press(key);
+        return { ...base, ok: true, key };
+      }
+      const locator = page.locator(action.selector);
+      const count = await locator.count();
+      if (!count) return { ...base, reason: "selector_not_found", count, key };
+      const targetIndex = Number.isInteger(action.index) ? action.index : 0;
+      if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex, key };
+      await locator.nth(targetIndex).press(key, { timeout });
+      return { ...base, ok: true, count, target_index: targetIndex, key };
+    }
     if (type === "local_storage" || type === "session_storage") {
       const value = setupActionValue(action);
       await page.evaluate(({ type, key, value }) => {
@@ -9305,6 +9342,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.js

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

package/dist/index.cjs

@@ -8746,12 +8746,14 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
 ];
 var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "click",
+  "press",
   "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",
@@ -8914,7 +8916,7 @@ function isSupportedCheckType(value) {
 }
 function normalizeSetupActionType(value, index) {
   const normalizedInput = String(value || "").trim().replace(/-/g, "_");
-  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput;
+  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput;
   if (RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.includes(normalized)) {
     return normalized;
   }
@@ -8967,6 +8969,9 @@ function normalizeSetupAction(input, index) {
     throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
   const key = stringValue5(input.key);
+  if (type === "press" && !key) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires key.`);
+  }
   if ((type === "local_storage" || type === "session_storage") && !key) {
     throw new Error(`target.setup_actions[${index}] ${type} requires key.`);
   }
@@ -8974,7 +8979,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 +8987,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 +9009,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 +10835,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; }
@@ -11040,6 +11062,21 @@ async function executeSetupAction(action, ordinal) {
       await page.waitForSelector(action.selector, { state: "visible", timeout });
       return { ...base, ok: true, timeout_ms: timeout };
     }
+    if (type === "press") {
+      const key = String(action.key || "").trim();
+      if (!key) return { ...base, reason: "missing_key" };
+      if (!action.selector) {
+        await page.keyboard.press(key);
+        return { ...base, ok: true, key };
+      }
+      const locator = page.locator(action.selector);
+      const count = await locator.count();
+      if (!count) return { ...base, reason: "selector_not_found", count, key };
+      const targetIndex = Number.isInteger(action.index) ? action.index : 0;
+      if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex, key };
+      await locator.nth(targetIndex).press(key, { timeout });
+      return { ...base, ok: true, count, target_index: targetIndex, key };
+    }
     if (type === "local_storage" || type === "session_storage") {
       const value = setupActionValue(action);
       await page.evaluate(({ type, key, value }) => {
@@ -11162,6 +11199,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-7ZBK2GQX.js";
 import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,

package/dist/profile.cjs

@@ -75,12 +75,14 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
 ];
 var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "click",
+  "press",
   "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",
@@ -243,7 +245,7 @@ function isSupportedCheckType(value) {
 }
 function normalizeSetupActionType(value, index) {
   const normalizedInput = String(value || "").trim().replace(/-/g, "_");
-  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput;
+  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput;
   if (RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.includes(normalized)) {
     return normalized;
   }
@@ -296,6 +298,9 @@ function normalizeSetupAction(input, index) {
     throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
   const key = stringValue(input.key);
+  if (type === "press" && !key) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires key.`);
+  }
   if ((type === "local_storage" || type === "session_storage") && !key) {
     throw new Error(`target.setup_actions[${index}] ${type} requires key.`);
   }
@@ -303,7 +308,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 +316,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 +338,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 +2164,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; }
@@ -2369,6 +2391,21 @@ async function executeSetupAction(action, ordinal) {
       await page.waitForSelector(action.selector, { state: "visible", timeout });
       return { ...base, ok: true, timeout_ms: timeout };
     }
+    if (type === "press") {
+      const key = String(action.key || "").trim();
+      if (!key) return { ...base, reason: "missing_key" };
+      if (!action.selector) {
+        await page.keyboard.press(key);
+        return { ...base, ok: true, key };
+      }
+      const locator = page.locator(action.selector);
+      const count = await locator.count();
+      if (!count) return { ...base, reason: "selector_not_found", count, key };
+      const targetIndex = Number.isInteger(action.index) ? action.index : 0;
+      if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex, key };
+      await locator.nth(targetIndex).press(key, { timeout });
+      return { ...base, ok: true, count, target_index: targetIndex, key };
+    }
     if (type === "local_storage" || type === "session_storage") {
       const value = setupActionValue(action);
       await page.evaluate(({ type, key, value }) => {
@@ -2491,6 +2528,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", "press", "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", "press", "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-7ZBK2GQX.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.56",
+  "version": "0.7.58",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",