npm - @riddledc/riddle-proof - Versions diffs - 0.7.181 → 0.7.183 - Mend

@riddledc/riddle-proof 0.7.181 → 0.7.183

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (15) hide show

package/README.md +5 -2
package/dist/{chunk-T664I6R3.js → chunk-X24EJSIU.js} +51 -16
package/dist/cli.cjs +181 -31
package/dist/cli.js +131 -16
package/dist/index.cjs +51 -16
package/dist/index.js +1 -1
package/dist/profile.cjs +51 -16
package/dist/profile.d.cts +1 -1
package/dist/profile.d.ts +1 -1
package/dist/profile.js +1 -1
package/dist/proof-run-core.d.cts +1 -1
package/dist/proof-run-core.d.ts +1 -1
package/dist/proof-run-engine.d.cts +3 -3
package/dist/proof-run-engine.d.ts +3 -3
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -402,7 +402,7 @@ when body matching overrides sequence order.
 `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`, `tap`, `drag`, `press`, `fill`, `set_input_value`, `set_range_value`,
+`click`, `tap`, `drag`, `press`, `key_down`, `key_up`, `fill`, `set_input_value`, `set_range_value`,
 `deterministic_runtime`, `canvas_signature`, `assert_text_visible`, `assert_text_absent`,
 `assert_selector_count`, `assert_window_value`, `assert_window_number`,
 `local_storage`, `session_storage`, `clear_storage`, `clear_console`,
@@ -418,7 +418,10 @@ 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.
 For canvas games that read key state rather than keypress events, add `hold_ms`
-or `holdMs` to keep the key down before releasing it.
+or `holdMs` to keep the key down before releasing it. When the profile needs
+to observe or wait on runtime evidence while a key remains held, use paired
+`key_down` / `key_up` actions around `wait`, `window_eval`, or
+`window_call_until` actions.
 Use `click_count` / `clickCount` / `clicks` from 1 to 10 on a single `click`
 action for atomic double-click or double-submit contracts where modeling the
 interaction as repeated setup actions would incorrectly require the target to

package/dist/{chunk-T664I6R3.js → chunk-X24EJSIU.js} RENAMED Viewed

@@ -47,6 +47,8 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "tap",
   "drag",
   "press",
+  "key_down",
+  "key_up",
   "fill",
   "set_input_value",
   "set_range_value",
@@ -611,8 +613,9 @@ function profileSetupTapReceipts(results) {
     reason: result.reason ?? result.error ?? null
   }));
 }
-function profileSetupPressReceipts(results) {
-  return results.filter((result) => profileSetupResultAction(result) === "press").map((result) => ({
+function profileSetupKeyboardReceipts(results) {
+  return results.filter((result) => ["press", "key_down", "key_up"].includes(profileSetupResultAction(result))).map((result) => ({
+    action: profileSetupResultAction(result),
     ordinal: result.ordinal ?? null,
     ok: result.ok !== false,
     selector: result.selector ?? null,
@@ -785,8 +788,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
       const sampledDragReceipts = sampleProfileSetupSummaryItems(dragReceipts, 8);
       const tapReceipts = profileSetupTapReceipts(results);
       const sampledTapReceipts = sampleProfileSetupSummaryItems(tapReceipts, 8);
-      const pressReceipts = profileSetupPressReceipts(results);
-      const sampledPressReceipts = sampleProfileSetupSummaryItems(pressReceipts, 8);
+      const keyboardReceipts = profileSetupKeyboardReceipts(results);
+      const sampledKeyboardReceipts = sampleProfileSetupSummaryItems(keyboardReceipts, 8);
       const canvasSignatureReceipts = profileSetupCanvasSignatureReceipts(results);
       const sampledCanvasSignatureReceipts = sampleProfileSetupSummaryItems(canvasSignatureReceipts, 8);
       const clickedItems = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => {
@@ -854,9 +857,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
         tap_total: tapReceipts.length,
         tap_truncated: tapReceipts.length > sampledTapReceipts.length,
         tap: sampledTapReceipts,
-        press_total: pressReceipts.length,
-        press_truncated: pressReceipts.length > sampledPressReceipts.length,
-        press: sampledPressReceipts,
+        keyboard_total: keyboardReceipts.length,
+        keyboard_truncated: keyboardReceipts.length > sampledKeyboardReceipts.length,
+        keyboard: sampledKeyboardReceipts,
         canvas_signature_total: canvasSignatureReceipts.length,
         canvas_signature_truncated: canvasSignatureReceipts.length > sampledCanvasSignatureReceipts.length,
         canvas_signature: sampledCanvasSignatureReceipts,
@@ -913,7 +916,7 @@ function isSupportedCheckType(value) {
 }
 function normalizeSetupActionType(value, index) {
   const normalizedInput = String(value || "").trim().replace(/-/g, "_");
-  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "reset_console" || normalizedInput === "clear_browser_console" || normalizedInput === "reset_browser_console" ? "clear_console" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "pointer_tap" || normalizedInput === "touch_tap" || normalizedInput === "canvas_tap" ? "tap" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput === "set_slider_value" || normalizedInput === "slider_value" || normalizedInput === "set_slider" || normalizedInput === "set_range" || normalizedInput === "range_value" || normalizedInput === "range_input" || normalizedInput === "set_range_input" ? "set_range_value" : normalizedInput === "deterministic_runtime" || normalizedInput === "mock_runtime" || normalizedInput === "mock_random" || normalizedInput === "mock_random_queue" || normalizedInput === "seed_random_queue" || normalizedInput === "set_random_queue" || normalizedInput === "mock_clock" || normalizedInput === "set_mock_clock" || normalizedInput === "set_runtime_determinism" || normalizedInput === "runtime_determinism" ? "deterministic_runtime" : normalizedInput === "canvas_hash" || normalizedInput === "capture_canvas_hash" || normalizedInput === "capture_canvas_signature" || normalizedInput === "canvas_state_signature" ? "canvas_signature" : normalizedInput === "capture_screenshot" || normalizedInput === "save_screenshot" || normalizedInput === "setup_screenshot" ? "screenshot" : normalizedInput === "accept_dialog" || normalizedInput === "accept_dialogs" || normalizedInput === "confirm_dialog" || normalizedInput === "set_dialog_response" ? "dialog_response" : normalizedInput === "dismiss_dialog" || normalizedInput === "dismiss_dialogs" || normalizedInput === "cancel_dialog" ? "dialog_response" : normalizedInput === "window_call_until" || normalizedInput === "call_until" || normalizedInput === "window_call_repeat_until" || normalizedInput === "repeat_window_call_until" ? "window_call_until" : normalizedInput === "window_evaluate" || normalizedInput === "browser_eval" || normalizedInput === "browser_evaluate" || normalizedInput === "evaluate_script" || normalizedInput === "profile_script" ? "window_eval" : normalizedInput;
+  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "reset_console" || normalizedInput === "clear_browser_console" || normalizedInput === "reset_browser_console" ? "clear_console" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "pointer_tap" || normalizedInput === "touch_tap" || normalizedInput === "canvas_tap" ? "tap" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput === "keyboard_down" || normalizedInput === "key_down" || normalizedInput === "keydown" || normalizedInput === "press_down" ? "key_down" : normalizedInput === "keyboard_up" || normalizedInput === "key_up" || normalizedInput === "keyup" || normalizedInput === "press_up" || normalizedInput === "release_key" || normalizedInput === "key_release" ? "key_up" : normalizedInput === "set_slider_value" || normalizedInput === "slider_value" || normalizedInput === "set_slider" || normalizedInput === "set_range" || normalizedInput === "range_value" || normalizedInput === "range_input" || normalizedInput === "set_range_input" ? "set_range_value" : normalizedInput === "deterministic_runtime" || normalizedInput === "mock_runtime" || normalizedInput === "mock_random" || normalizedInput === "mock_random_queue" || normalizedInput === "seed_random_queue" || normalizedInput === "set_random_queue" || normalizedInput === "mock_clock" || normalizedInput === "set_mock_clock" || normalizedInput === "set_runtime_determinism" || normalizedInput === "runtime_determinism" ? "deterministic_runtime" : normalizedInput === "canvas_hash" || normalizedInput === "capture_canvas_hash" || normalizedInput === "capture_canvas_signature" || normalizedInput === "canvas_state_signature" ? "canvas_signature" : normalizedInput === "capture_screenshot" || normalizedInput === "save_screenshot" || normalizedInput === "setup_screenshot" ? "screenshot" : normalizedInput === "accept_dialog" || normalizedInput === "accept_dialogs" || normalizedInput === "confirm_dialog" || normalizedInput === "set_dialog_response" ? "dialog_response" : normalizedInput === "dismiss_dialog" || normalizedInput === "dismiss_dialogs" || normalizedInput === "cancel_dialog" ? "dialog_response" : normalizedInput === "window_call_until" || normalizedInput === "call_until" || normalizedInput === "window_call_repeat_until" || normalizedInput === "repeat_window_call_until" ? "window_call_until" : normalizedInput === "window_evaluate" || normalizedInput === "browser_eval" || normalizedInput === "browser_evaluate" || normalizedInput === "evaluate_script" || normalizedInput === "profile_script" ? "window_eval" : normalizedInput;
   if (RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.includes(normalized)) {
     return normalized;
   }
@@ -1169,7 +1172,7 @@ function normalizeSetupAction(input, index) {
       dialogAccept = true;
     }
   }
-  if (type === "press" && !key) {
+  if ((type === "press" || type === "key_down" || type === "key_up") && !key) {
     throw new Error(`target.setup_actions[${index}] ${type} requires key.`);
   }
   if ((type === "local_storage" || type === "session_storage") && !key) {
@@ -4494,10 +4497,11 @@ function profileSetupTapReceipts(results) {
       reason: result.reason || result.error || null,
     }));
 }
-function profileSetupPressReceipts(results) {
+function profileSetupKeyboardReceipts(results) {
   return (results || [])
-    .filter((result) => result && profileSetupResultAction(result) === "press")
+    .filter((result) => result && ["press", "key_down", "key_up"].includes(profileSetupResultAction(result)))
     .map((result) => ({
+      action: profileSetupResultAction(result),
       ordinal: result.ordinal ?? null,
       ok: result.ok !== false,
       selector: result.selector ?? null,
@@ -4695,8 +4699,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
       const sampledDragReceipts = sampleProfileSetupSummaryItems(dragReceipts, 8);
       const tapReceipts = profileSetupTapReceipts(results);
       const sampledTapReceipts = sampleProfileSetupSummaryItems(tapReceipts, 8);
-      const pressReceipts = profileSetupPressReceipts(results);
-      const sampledPressReceipts = sampleProfileSetupSummaryItems(pressReceipts, 8);
+      const keyboardReceipts = profileSetupKeyboardReceipts(results);
+      const sampledKeyboardReceipts = sampleProfileSetupSummaryItems(keyboardReceipts, 8);
       const canvasSignatureReceipts = profileSetupCanvasSignatureReceipts(results);
       const sampledCanvasSignatureReceipts = sampleProfileSetupSummaryItems(canvasSignatureReceipts, 8);
       const clickedItems = results
@@ -4774,9 +4778,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         tap_total: tapReceipts.length,
         tap_truncated: tapReceipts.length > sampledTapReceipts.length,
         tap: sampledTapReceipts,
-        press_total: pressReceipts.length,
-        press_truncated: pressReceipts.length > sampledPressReceipts.length,
-        press: sampledPressReceipts,
+        keyboard_total: keyboardReceipts.length,
+        keyboard_truncated: keyboardReceipts.length > sampledKeyboardReceipts.length,
+        keyboard: sampledKeyboardReceipts,
         canvas_signature_total: canvasSignatureReceipts.length,
         canvas_signature_truncated: canvasSignatureReceipts.length > sampledCanvasSignatureReceipts.length,
         canvas_signature: sampledCanvasSignatureReceipts,
@@ -6437,6 +6441,37 @@ async function executeSetupAction(action, ordinal, viewport) {
         duration_ms: durationMs || undefined,
       };
     }
+    if (type === "key_down" || type === "key_up") {
+      const key = String(action.key || "").trim();
+      if (!key) return { ...base, reason: "missing_key" };
+      const scope = await setupActionScope(action, timeout);
+      if (!scope.ok) return setupScopeFailure(base, scope);
+      let count;
+      let targetIndex;
+      if (action.selector) {
+        const locator = scope.context.locator(action.selector);
+        count = await locator.count();
+        if (!count) return { ...base, reason: "selector_not_found", count, key };
+        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).focus({ timeout }).catch(() => {});
+      } else if (scope.frame_selector) {
+        await scope.context.locator("body").focus({ timeout }).catch(() => {});
+      }
+      if (type === "key_down") {
+        await page.keyboard.down(key);
+      } else {
+        await page.keyboard.up(key);
+      }
+      return {
+        ...base,
+        ...setupScopeEvidence(scope),
+        ok: true,
+        count,
+        target_index: targetIndex,
+        key,
+      };
+    }
     if (type === "press") {
       const key = String(action.key || "").trim();
       if (!key) return { ...base, reason: "missing_key" };

package/dist/cli.cjs CHANGED Viewed

@@ -7004,6 +7004,8 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "tap",
   "drag",
   "press",
+  "key_down",
+  "key_up",
   "fill",
   "set_input_value",
   "set_range_value",
@@ -7568,8 +7570,9 @@ function profileSetupTapReceipts(results) {
     reason: result.reason ?? result.error ?? null
   }));
 }
-function profileSetupPressReceipts(results) {
-  return results.filter((result) => profileSetupResultAction(result) === "press").map((result) => ({
+function profileSetupKeyboardReceipts(results) {
+  return results.filter((result) => ["press", "key_down", "key_up"].includes(profileSetupResultAction(result))).map((result) => ({
+    action: profileSetupResultAction(result),
     ordinal: result.ordinal ?? null,
     ok: result.ok !== false,
     selector: result.selector ?? null,
@@ -7742,8 +7745,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
       const sampledDragReceipts = sampleProfileSetupSummaryItems(dragReceipts, 8);
       const tapReceipts = profileSetupTapReceipts(results);
       const sampledTapReceipts = sampleProfileSetupSummaryItems(tapReceipts, 8);
-      const pressReceipts = profileSetupPressReceipts(results);
-      const sampledPressReceipts = sampleProfileSetupSummaryItems(pressReceipts, 8);
+      const keyboardReceipts = profileSetupKeyboardReceipts(results);
+      const sampledKeyboardReceipts = sampleProfileSetupSummaryItems(keyboardReceipts, 8);
       const canvasSignatureReceipts = profileSetupCanvasSignatureReceipts(results);
       const sampledCanvasSignatureReceipts = sampleProfileSetupSummaryItems(canvasSignatureReceipts, 8);
       const clickedItems = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => {
@@ -7811,9 +7814,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
         tap_total: tapReceipts.length,
         tap_truncated: tapReceipts.length > sampledTapReceipts.length,
         tap: sampledTapReceipts,
-        press_total: pressReceipts.length,
-        press_truncated: pressReceipts.length > sampledPressReceipts.length,
-        press: sampledPressReceipts,
+        keyboard_total: keyboardReceipts.length,
+        keyboard_truncated: keyboardReceipts.length > sampledKeyboardReceipts.length,
+        keyboard: sampledKeyboardReceipts,
         canvas_signature_total: canvasSignatureReceipts.length,
         canvas_signature_truncated: canvasSignatureReceipts.length > sampledCanvasSignatureReceipts.length,
         canvas_signature: sampledCanvasSignatureReceipts,
@@ -7870,7 +7873,7 @@ function isSupportedCheckType(value) {
 }
 function normalizeSetupActionType(value, index) {
   const normalizedInput = String(value || "").trim().replace(/-/g, "_");
-  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "reset_console" || normalizedInput === "clear_browser_console" || normalizedInput === "reset_browser_console" ? "clear_console" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "pointer_tap" || normalizedInput === "touch_tap" || normalizedInput === "canvas_tap" ? "tap" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput === "set_slider_value" || normalizedInput === "slider_value" || normalizedInput === "set_slider" || normalizedInput === "set_range" || normalizedInput === "range_value" || normalizedInput === "range_input" || normalizedInput === "set_range_input" ? "set_range_value" : normalizedInput === "deterministic_runtime" || normalizedInput === "mock_runtime" || normalizedInput === "mock_random" || normalizedInput === "mock_random_queue" || normalizedInput === "seed_random_queue" || normalizedInput === "set_random_queue" || normalizedInput === "mock_clock" || normalizedInput === "set_mock_clock" || normalizedInput === "set_runtime_determinism" || normalizedInput === "runtime_determinism" ? "deterministic_runtime" : normalizedInput === "canvas_hash" || normalizedInput === "capture_canvas_hash" || normalizedInput === "capture_canvas_signature" || normalizedInput === "canvas_state_signature" ? "canvas_signature" : normalizedInput === "capture_screenshot" || normalizedInput === "save_screenshot" || normalizedInput === "setup_screenshot" ? "screenshot" : normalizedInput === "accept_dialog" || normalizedInput === "accept_dialogs" || normalizedInput === "confirm_dialog" || normalizedInput === "set_dialog_response" ? "dialog_response" : normalizedInput === "dismiss_dialog" || normalizedInput === "dismiss_dialogs" || normalizedInput === "cancel_dialog" ? "dialog_response" : normalizedInput === "window_call_until" || normalizedInput === "call_until" || normalizedInput === "window_call_repeat_until" || normalizedInput === "repeat_window_call_until" ? "window_call_until" : normalizedInput === "window_evaluate" || normalizedInput === "browser_eval" || normalizedInput === "browser_evaluate" || normalizedInput === "evaluate_script" || normalizedInput === "profile_script" ? "window_eval" : normalizedInput;
+  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "reset_console" || normalizedInput === "clear_browser_console" || normalizedInput === "reset_browser_console" ? "clear_console" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "pointer_tap" || normalizedInput === "touch_tap" || normalizedInput === "canvas_tap" ? "tap" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput === "keyboard_down" || normalizedInput === "key_down" || normalizedInput === "keydown" || normalizedInput === "press_down" ? "key_down" : normalizedInput === "keyboard_up" || normalizedInput === "key_up" || normalizedInput === "keyup" || normalizedInput === "press_up" || normalizedInput === "release_key" || normalizedInput === "key_release" ? "key_up" : normalizedInput === "set_slider_value" || normalizedInput === "slider_value" || normalizedInput === "set_slider" || normalizedInput === "set_range" || normalizedInput === "range_value" || normalizedInput === "range_input" || normalizedInput === "set_range_input" ? "set_range_value" : normalizedInput === "deterministic_runtime" || normalizedInput === "mock_runtime" || normalizedInput === "mock_random" || normalizedInput === "mock_random_queue" || normalizedInput === "seed_random_queue" || normalizedInput === "set_random_queue" || normalizedInput === "mock_clock" || normalizedInput === "set_mock_clock" || normalizedInput === "set_runtime_determinism" || normalizedInput === "runtime_determinism" ? "deterministic_runtime" : normalizedInput === "canvas_hash" || normalizedInput === "capture_canvas_hash" || normalizedInput === "capture_canvas_signature" || normalizedInput === "canvas_state_signature" ? "canvas_signature" : normalizedInput === "capture_screenshot" || normalizedInput === "save_screenshot" || normalizedInput === "setup_screenshot" ? "screenshot" : normalizedInput === "accept_dialog" || normalizedInput === "accept_dialogs" || normalizedInput === "confirm_dialog" || normalizedInput === "set_dialog_response" ? "dialog_response" : normalizedInput === "dismiss_dialog" || normalizedInput === "dismiss_dialogs" || normalizedInput === "cancel_dialog" ? "dialog_response" : normalizedInput === "window_call_until" || normalizedInput === "call_until" || normalizedInput === "window_call_repeat_until" || normalizedInput === "repeat_window_call_until" ? "window_call_until" : normalizedInput === "window_evaluate" || normalizedInput === "browser_eval" || normalizedInput === "browser_evaluate" || normalizedInput === "evaluate_script" || normalizedInput === "profile_script" ? "window_eval" : normalizedInput;
   if (RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.includes(normalized)) {
     return normalized;
   }
@@ -8126,7 +8129,7 @@ function normalizeSetupAction(input, index) {
       dialogAccept = true;
     }
   }
-  if (type === "press" && !key) {
+  if ((type === "press" || type === "key_down" || type === "key_up") && !key) {
     throw new Error(`target.setup_actions[${index}] ${type} requires key.`);
   }
   if ((type === "local_storage" || type === "session_storage") && !key) {
@@ -11435,10 +11438,11 @@ function profileSetupTapReceipts(results) {
       reason: result.reason || result.error || null,
     }));
 }
-function profileSetupPressReceipts(results) {
+function profileSetupKeyboardReceipts(results) {
   return (results || [])
-    .filter((result) => result && profileSetupResultAction(result) === "press")
+    .filter((result) => result && ["press", "key_down", "key_up"].includes(profileSetupResultAction(result)))
     .map((result) => ({
+      action: profileSetupResultAction(result),
       ordinal: result.ordinal ?? null,
       ok: result.ok !== false,
       selector: result.selector ?? null,
@@ -11636,8 +11640,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
       const sampledDragReceipts = sampleProfileSetupSummaryItems(dragReceipts, 8);
       const tapReceipts = profileSetupTapReceipts(results);
       const sampledTapReceipts = sampleProfileSetupSummaryItems(tapReceipts, 8);
-      const pressReceipts = profileSetupPressReceipts(results);
-      const sampledPressReceipts = sampleProfileSetupSummaryItems(pressReceipts, 8);
+      const keyboardReceipts = profileSetupKeyboardReceipts(results);
+      const sampledKeyboardReceipts = sampleProfileSetupSummaryItems(keyboardReceipts, 8);
       const canvasSignatureReceipts = profileSetupCanvasSignatureReceipts(results);
       const sampledCanvasSignatureReceipts = sampleProfileSetupSummaryItems(canvasSignatureReceipts, 8);
       const clickedItems = results
@@ -11715,9 +11719,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         tap_total: tapReceipts.length,
         tap_truncated: tapReceipts.length > sampledTapReceipts.length,
         tap: sampledTapReceipts,
-        press_total: pressReceipts.length,
-        press_truncated: pressReceipts.length > sampledPressReceipts.length,
-        press: sampledPressReceipts,
+        keyboard_total: keyboardReceipts.length,
+        keyboard_truncated: keyboardReceipts.length > sampledKeyboardReceipts.length,
+        keyboard: sampledKeyboardReceipts,
         canvas_signature_total: canvasSignatureReceipts.length,
         canvas_signature_truncated: canvasSignatureReceipts.length > sampledCanvasSignatureReceipts.length,
         canvas_signature: sampledCanvasSignatureReceipts,
@@ -13378,6 +13382,37 @@ async function executeSetupAction(action, ordinal, viewport) {
         duration_ms: durationMs || undefined,
       };
     }
+    if (type === "key_down" || type === "key_up") {
+      const key = String(action.key || "").trim();
+      if (!key) return { ...base, reason: "missing_key" };
+      const scope = await setupActionScope(action, timeout);
+      if (!scope.ok) return setupScopeFailure(base, scope);
+      let count;
+      let targetIndex;
+      if (action.selector) {
+        const locator = scope.context.locator(action.selector);
+        count = await locator.count();
+        if (!count) return { ...base, reason: "selector_not_found", count, key };
+        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).focus({ timeout }).catch(() => {});
+      } else if (scope.frame_selector) {
+        await scope.context.locator("body").focus({ timeout }).catch(() => {});
+      }
+      if (type === "key_down") {
+        await page.keyboard.down(key);
+      } else {
+        await page.keyboard.up(key);
+      }
+      return {
+        ...base,
+        ...setupScopeEvidence(scope),
+        ok: true,
+        count,
+        target_index: targetIndex,
+        key,
+      };
+    }
     if (type === "press") {
       const key = String(action.key || "").trim();
       if (!key) return { ...base, reason: "missing_key" };
@@ -16370,7 +16405,18 @@ function profileCheckMarkdownTarget(check) {
   }
   if (check.type === "no_console_warnings") {
     const warningCount = cliFiniteNumber(evidence.console_warning_count) ?? 0;
-    return `${warningCount} unallowed warning${warningCount === 1 ? "" : "s"}`;
+    const totalConsoleCount = cliFiniteNumber(evidence.total_console_warning_count);
+    const allowedConsoleCount = cliFiniteNumber(evidence.allowed_console_warning_count);
+    const allowedTextCount = Array.isArray(evidence.allowed_console_texts) ? evidence.allowed_console_texts.filter((value) => typeof value === "string" && value.trim()).length : 0;
+    const allowedPatternCount = Array.isArray(evidence.allowed_console_patterns) ? evidence.allowed_console_patterns.filter((value) => typeof value === "string" && value.trim()).length : 0;
+    const parts = [`${warningCount} unallowed warning${warningCount === 1 ? "" : "s"}`];
+    if (totalConsoleCount !== void 0 && allowedConsoleCount !== void 0) {
+      parts.push(`${allowedConsoleCount}/${totalConsoleCount} warning${totalConsoleCount === 1 ? "" : "s"} allowed`);
+    }
+    if (allowedTextCount || allowedPatternCount) {
+      parts.push(`allowlist ${allowedTextCount} text${allowedTextCount === 1 ? "" : "s"}, ${allowedPatternCount} pattern${allowedPatternCount === 1 ? "" : "s"}`);
+    }
+    return parts.join(", ");
   }
   return void 0;
 }
@@ -16407,6 +16453,100 @@ function cliReturnSummaryLabel(value) {
   }).filter(Boolean);
   return parts.length ? parts.join(", ") : void 0;
 }
+function setupFailureObstructionSnippet(reason) {
+  if (!reason || !reason.includes("intercepts pointer events")) return void 0;
+  const line = reason.split(/\r?\n/).find((item) => item.includes("intercepts pointer events"));
+  const match = line?.match(/-\s+(.+?)\s+intercepts pointer events/);
+  const snippet = match?.[1]?.replace(/\s+/g, " ").trim();
+  return snippet || void 0;
+}
+function setupReceiptArray(viewport, key) {
+  return Array.isArray(viewport[key]) ? viewport[key].map(cliRecord).filter((item) => Boolean(item)) : [];
+}
+function setupReturnSummaryValue(receipt, names) {
+  for (const name of names) {
+    if (receipt[name] !== void 0) return receipt[name];
+  }
+  const returned = cliRecord(receipt.returned);
+  for (const name of names) {
+    if (returned?.[name] !== void 0) return returned[name];
+  }
+  const summaries = Array.isArray(receipt.return_summary) ? receipt.return_summary.map(cliRecord).filter((item) => Boolean(item)) : [];
+  for (const item of summaries) {
+    const label = cliString(item.label);
+    const path7 = cliString(item.path);
+    if (names.some((name) => label === name || path7 === name)) return item.value;
+  }
+  return void 0;
+}
+function setupMetricPart(receipts, label, names = [label]) {
+  for (const receipt of receipts) {
+    const value = setupReturnSummaryValue(receipt, names);
+    const valueLabel = cliValueLabel(value);
+    if (valueLabel !== void 0) return `${label}=${valueLabel}`;
+  }
+  return void 0;
+}
+function setupInputReceiptLabel(kind, receipt) {
+  const selector = cliString(receipt.selector);
+  const pointerType = cliString(receipt.pointer_type);
+  const inputDispatch = cliString(receipt.input_dispatch);
+  const key = cliString(receipt.key);
+  return [
+    kind,
+    selector ? markdownInlineCode(selector) : "",
+    pointerType ? markdownInlineCode(pointerType) : "",
+    key ? markdownInlineCode(key) : "",
+    inputDispatch ? `via ${markdownInlineCode(inputDispatch)}` : ""
+  ].filter(Boolean).join(" ");
+}
+function setupCanvasHashChangeLabel(receipts) {
+  const changed = receipts.find((receipt) => cliString(receipt.previous_hash) && cliString(receipt.hash) && receipt.changed === true);
+  if (changed) return `${markdownInlineCode(cliString(changed.previous_hash) || "")} -> ${markdownInlineCode(cliString(changed.hash) || "")}`;
+  const hashes = receipts.map((receipt) => cliString(receipt.hash)).filter((hash) => Boolean(hash));
+  const first = hashes[0];
+  const last = [...hashes].reverse().find((hash) => hash !== first);
+  return first && last ? `${markdownInlineCode(first)} -> ${markdownInlineCode(last)}` : void 0;
+}
+function setupNaturalInputSummaryMarkdown(viewports) {
+  const lines = [];
+  for (const viewport of viewports.slice(0, 8)) {
+    const name = cliString(viewport.name) || "viewport";
+    const inputReceipts = [
+      ...setupReceiptArray(viewport, "drag").map((receipt) => ({ kind: "drag", receipt })),
+      ...setupReceiptArray(viewport, "tap").map((receipt) => ({ kind: "tap", receipt })),
+      ...setupReceiptArray(viewport, "press").map((receipt) => ({ kind: "press", receipt }))
+    ].filter(({ receipt }) => receipt.ok !== false);
+    if (!inputReceipts.length) continue;
+    const valueReceipts = [
+      ...setupReceiptArray(viewport, "window_eval"),
+      ...setupReceiptArray(viewport, "window_call")
+    ].filter((receipt) => receipt.ok !== false);
+    const canvasReceipts = setupReceiptArray(viewport, "canvas_signature").filter((receipt) => receipt.ok !== false);
+    const eventParts = [
+      setupMetricPart(valueReceipts, "pointerDowns"),
+      setupMetricPart(valueReceipts, "pointerMoves"),
+      setupMetricPart(valueReceipts, "pointerUps"),
+      setupMetricPart(valueReceipts, "trustedEvents"),
+      setupMetricPart(valueReceipts, "eventCount")
+    ].filter((part) => Boolean(part));
+    const pixelParts = [
+      setupMetricPart(valueReceipts, "nonWhiteDelta"),
+      setupMetricPart(valueReceipts, "darkDelta")
+    ].filter((part) => Boolean(part));
+    const hashChange = setupCanvasHashChangeLabel(canvasReceipts);
+    if (!eventParts.length && !pixelParts.length && !hashChange) continue;
+    const inputText = inputReceipts.slice(0, 3).map(({ kind, receipt }) => setupInputReceiptLabel(kind, receipt)).join(", ");
+    const parts = [
+      inputText,
+      eventParts.length ? `events ${eventParts.join(", ")}` : "",
+      pixelParts.length ? `pixel deltas ${pixelParts.join(", ")}` : "",
+      hashChange ? `canvas hash ${hashChange}` : ""
+    ].filter(Boolean);
+    lines.push(`- natural input ${name}: ${parts.join("; ")}`);
+  }
+  return lines;
+}
 function balancedSetupReceiptDetails(groups, limit) {
   if (limit <= 0) return [];
   const total = groups.reduce((sum, group) => sum + group.length, 0);
@@ -16554,7 +16694,10 @@ function profileSetupSummaryMarkdown(result) {
   const rangeValueTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.set_range_value_total) || 0), 0);
   const dragTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.drag_total) || 0), 0);
   const tapTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.tap_total) || 0), 0);
-  const pressTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.press_total) || 0), 0);
+  const keyboardTotal = viewports.reduce((sum, viewport) => {
+    const total = cliFiniteNumber(viewport.keyboard_total);
+    return sum + (total === void 0 ? cliFiniteNumber(viewport.press_total) || 0 : total);
+  }, 0);
   const canvasSignatureTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.canvas_signature_total) || 0), 0);
   const failedTotal = viewports.reduce((sum, viewport) => sum + (Array.isArray(viewport.failed) ? viewport.failed.length : 0), 0);
   const lines = [
@@ -16590,12 +16733,13 @@ function profileSetupSummaryMarkdown(result) {
   if (tapTotal) {
     lines.push(`- tap: ${tapTotal} action(s)`);
   }
-  if (pressTotal) {
-    lines.push(`- press: ${pressTotal} action(s)`);
+  if (keyboardTotal) {
+    lines.push(`- keyboard: ${keyboardTotal} action(s)`);
   }
   if (canvasSignatureTotal) {
     lines.push(`- canvas_signature: ${canvasSignatureTotal} action(s)`);
   }
+  lines.push(...setupNaturalInputSummaryMarkdown(viewports));
   for (const viewport of viewports.slice(0, 8)) {
     const name = cliString(viewport.name) || "viewport";
     const ok = viewport.ok === false ? "failed" : "ok";
@@ -16616,10 +16760,10 @@ function profileSetupSummaryMarkdown(result) {
     const rangeValueActions = cliFiniteNumber(viewport.set_range_value_total) || 0;
     const dragActions = cliFiniteNumber(viewport.drag_total) || 0;
     const tapActions = cliFiniteNumber(viewport.tap_total) || 0;
-    const pressActions = cliFiniteNumber(viewport.press_total) || 0;
+    const keyboardActions = cliFiniteNumber(viewport.keyboard_total) ?? cliFiniteNumber(viewport.press_total) ?? 0;
     const canvasSignatureActions = cliFiniteNumber(viewport.canvas_signature_total) || 0;
     const observedPath = cliString(viewport.observed_path);
-    lines.push(`- ${name}: ${ok}, ${resultCount} result(s), ${screenshotCount} setup screenshot(s), ${clicked} click(s)${clickSequenceCount ? `, ${clickSequenceCount} click sequence(s)` : ""}${clickCountActions ? `, ${clickCountActions} click_count action(s)` : ""}${rangeValueActions ? `, ${rangeValueActions} set_range_value action(s)` : ""}${dragActions ? `, ${dragActions} drag action(s)` : ""}${tapActions ? `, ${tapActions} tap action(s)` : ""}${pressActions ? `, ${pressActions} press action(s)` : ""}${canvasSignatureActions ? `, ${canvasSignatureActions} canvas_signature action(s)` : ""}${deterministicRuntimeActions ? `, ${deterministicRuntimeActions} deterministic_runtime action(s)` : ""}${windowCallActions ? `, ${windowCallActions} window_call action(s), ${windowCallStored} stored return(s), ${windowCallCaptured} captured return(s)` : ""}${windowEvalActions ? `, ${windowEvalActions} window_eval action(s), ${windowEvalStored} stored return(s), ${windowEvalCaptured} captured return(s)` : ""}${windowCallUntilActions ? `, ${windowCallUntilActions} window_call_until action(s), ${windowCallUntilCalls} call(s)` : ""}${observedPath ? `, path ${observedPath}` : ""}`);
+    lines.push(`- ${name}: ${ok}, ${resultCount} result(s), ${screenshotCount} setup screenshot(s), ${clicked} click(s)${clickSequenceCount ? `, ${clickSequenceCount} click sequence(s)` : ""}${clickCountActions ? `, ${clickCountActions} click_count action(s)` : ""}${rangeValueActions ? `, ${rangeValueActions} set_range_value action(s)` : ""}${dragActions ? `, ${dragActions} drag action(s)` : ""}${tapActions ? `, ${tapActions} tap action(s)` : ""}${keyboardActions ? `, ${keyboardActions} keyboard action(s)` : ""}${canvasSignatureActions ? `, ${canvasSignatureActions} canvas_signature action(s)` : ""}${deterministicRuntimeActions ? `, ${deterministicRuntimeActions} deterministic_runtime action(s)` : ""}${windowCallActions ? `, ${windowCallActions} window_call action(s), ${windowCallStored} stored return(s), ${windowCallCaptured} captured return(s)` : ""}${windowEvalActions ? `, ${windowEvalActions} window_eval action(s), ${windowEvalStored} stored return(s), ${windowEvalCaptured} captured return(s)` : ""}${windowCallUntilActions ? `, ${windowCallUntilActions} window_call_until action(s), ${windowCallUntilCalls} call(s)` : ""}${observedPath ? `, path ${observedPath}` : ""}`);
   }
   const clickSequenceGroups = viewports.map((viewport) => {
     const name = cliString(viewport.name) || "viewport";
@@ -16686,13 +16830,14 @@ function profileSetupSummaryMarkdown(result) {
     lines.push(`- ${name} tap: ${ok}, ${markdownInlineCode(selector)}${pointerType ? ` ${markdownInlineCode(pointerType)}` : ""}${inputDispatch ? ` via ${markdownInlineCode(inputDispatch)}` : ""}${coordinateText}${durationMs === void 0 ? "" : `, duration ${durationMs}ms`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
   }
   if (tapDetails.length > sampledTapDetails.length) lines.push(`- ${tapDetails.length - sampledTapDetails.length} additional tap receipt(s) omitted.`);
-  const pressGroups = viewports.map((viewport) => {
+  const keyboardGroups = viewports.map((viewport) => {
     const name = cliString(viewport.name) || "viewport";
-    const receipts = Array.isArray(viewport.press) ? viewport.press.map(cliRecord).filter((item) => Boolean(item)) : [];
+    const rawReceipts = Array.isArray(viewport.keyboard) ? viewport.keyboard : viewport.press;
+    const receipts = Array.isArray(rawReceipts) ? rawReceipts.map(cliRecord).filter((item) => Boolean(item)) : [];
     return receipts.map((receipt) => ({ name, receipt }));
   });
-  const pressDetails = pressGroups.flat();
-  for (const group of pressGroups.slice(0, 8)) {
+  const keyboardDetails = keyboardGroups.flat();
+  for (const group of keyboardGroups.slice(0, 8)) {
     if (!group.length) continue;
     const name = group[0].name;
     const keys = group.map(({ receipt }) => cliString(receipt.key) || "key").filter(Boolean);
@@ -16703,19 +16848,20 @@ function profileSetupSummaryMarkdown(result) {
     const omittedOrdinalCount = Math.max(0, ordinals.length - visibleOrdinals.length);
     const keyText = visibleKeys.join(",");
     const ordinalText = visibleOrdinals.join(",");
-    lines.push(`- ${name} press_sequence: keys ${markdownInlineCode(keyText, 200)}${omittedKeyCount ? ` (+${omittedKeyCount} omitted)` : ""}${ordinalText ? `, ordinals ${markdownInlineCode(ordinalText, 120)}${omittedOrdinalCount ? ` (+${omittedOrdinalCount} omitted)` : ""}` : ""}`);
+    lines.push(`- ${name} keyboard_sequence: keys ${markdownInlineCode(keyText, 200)}${omittedKeyCount ? ` (+${omittedKeyCount} omitted)` : ""}${ordinalText ? `, ordinals ${markdownInlineCode(ordinalText, 120)}${omittedOrdinalCount ? ` (+${omittedOrdinalCount} omitted)` : ""}` : ""}`);
   }
-  const sampledPressDetails = balancedSetupReceiptDetails(pressGroups, 12);
-  for (const { name, receipt } of sampledPressDetails) {
+  const sampledKeyboardDetails = balancedSetupReceiptDetails(keyboardGroups, 12);
+  for (const { name, receipt } of sampledKeyboardDetails) {
+    const action = cliString(receipt.action) || "press";
     const key = cliString(receipt.key) || "key";
     const selector = cliString(receipt.selector);
     const frameSelector = cliString(receipt.frame_selector);
     const holdMs = cliFiniteNumber(receipt.hold_ms);
     const ok = receipt.ok === false ? "failed" : "ok";
     const reason = cliString(receipt.reason);
-    lines.push(`- ${name} press: ${ok}, ${markdownInlineCode(key)}${selector ? ` on ${markdownInlineCode(selector)}` : ""}${frameSelector ? ` in frame ${markdownInlineCode(frameSelector)}` : ""}${holdMs === void 0 ? "" : `, held ${holdMs}ms`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
+    lines.push(`- ${name} ${action}: ${ok}, ${markdownInlineCode(key)}${selector ? ` on ${markdownInlineCode(selector)}` : ""}${frameSelector ? ` in frame ${markdownInlineCode(frameSelector)}` : ""}${holdMs === void 0 ? "" : `, held ${holdMs}ms`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
   }
-  if (pressDetails.length > sampledPressDetails.length) lines.push(`- ${pressDetails.length - sampledPressDetails.length} additional press receipt(s) omitted.`);
+  if (keyboardDetails.length > sampledKeyboardDetails.length) lines.push(`- ${keyboardDetails.length - sampledKeyboardDetails.length} additional keyboard receipt(s) omitted.`);
   const canvasSignatureGroups = viewports.map((viewport) => {
     const name = cliString(viewport.name) || "viewport";
     const receipts = Array.isArray(viewport.canvas_signature) ? viewport.canvas_signature.map(cliRecord).filter((item) => Boolean(item)) : [];
@@ -16876,7 +17022,11 @@ function profileSetupSummaryMarkdown(result) {
     const selector = cliString(failure.selector);
     const reason = cliString(failure.reason);
     const caseInsensitiveText = cliString(failure.case_insensitive_text);
+    const obstruction = setupFailureObstructionSnippet(reason);
     lines.push(`- failed ${name}: ${action}${selector ? ` ${markdownInlineCode(selector)}` : ""}${reason ? ` reason ${markdownInlineCode(reason)}` : ""}${caseInsensitiveText ? `; case-insensitive sample ${markdownInlineCode(caseInsensitiveText, 140)}` : ""}`);
+    if (obstruction) {
+      lines.push(`- obstruction ${name}: target ${selector ? markdownInlineCode(selector) : markdownInlineCode(action)} intercepted by ${markdownInlineCode(obstruction, 120)}`);
+    }
   }
   if (failedDetails.length > 8) lines.push(`- ${failedDetails.length - 8} additional failed setup action(s) omitted.`);
   if (viewports.length > 8) lines.push(`- ${viewports.length - 8} additional viewport(s) omitted from setup summary.`);

package/dist/cli.js CHANGED Viewed

@@ -13,7 +13,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-T664I6R3.js";
+} from "./chunk-X24EJSIU.js";
 import {
   createRiddleApiClient,
   isTerminalRiddleJobStatus,
@@ -622,7 +622,18 @@ function profileCheckMarkdownTarget(check) {
   }
   if (check.type === "no_console_warnings") {
     const warningCount = cliFiniteNumber(evidence.console_warning_count) ?? 0;
-    return `${warningCount} unallowed warning${warningCount === 1 ? "" : "s"}`;
+    const totalConsoleCount = cliFiniteNumber(evidence.total_console_warning_count);
+    const allowedConsoleCount = cliFiniteNumber(evidence.allowed_console_warning_count);
+    const allowedTextCount = Array.isArray(evidence.allowed_console_texts) ? evidence.allowed_console_texts.filter((value) => typeof value === "string" && value.trim()).length : 0;
+    const allowedPatternCount = Array.isArray(evidence.allowed_console_patterns) ? evidence.allowed_console_patterns.filter((value) => typeof value === "string" && value.trim()).length : 0;
+    const parts = [`${warningCount} unallowed warning${warningCount === 1 ? "" : "s"}`];
+    if (totalConsoleCount !== void 0 && allowedConsoleCount !== void 0) {
+      parts.push(`${allowedConsoleCount}/${totalConsoleCount} warning${totalConsoleCount === 1 ? "" : "s"} allowed`);
+    }
+    if (allowedTextCount || allowedPatternCount) {
+      parts.push(`allowlist ${allowedTextCount} text${allowedTextCount === 1 ? "" : "s"}, ${allowedPatternCount} pattern${allowedPatternCount === 1 ? "" : "s"}`);
+    }
+    return parts.join(", ");
   }
   return void 0;
 }
@@ -659,6 +670,100 @@ function cliReturnSummaryLabel(value) {
   }).filter(Boolean);
   return parts.length ? parts.join(", ") : void 0;
 }
+function setupFailureObstructionSnippet(reason) {
+  if (!reason || !reason.includes("intercepts pointer events")) return void 0;
+  const line = reason.split(/\r?\n/).find((item) => item.includes("intercepts pointer events"));
+  const match = line?.match(/-\s+(.+?)\s+intercepts pointer events/);
+  const snippet = match?.[1]?.replace(/\s+/g, " ").trim();
+  return snippet || void 0;
+}
+function setupReceiptArray(viewport, key) {
+  return Array.isArray(viewport[key]) ? viewport[key].map(cliRecord).filter((item) => Boolean(item)) : [];
+}
+function setupReturnSummaryValue(receipt, names) {
+  for (const name of names) {
+    if (receipt[name] !== void 0) return receipt[name];
+  }
+  const returned = cliRecord(receipt.returned);
+  for (const name of names) {
+    if (returned?.[name] !== void 0) return returned[name];
+  }
+  const summaries = Array.isArray(receipt.return_summary) ? receipt.return_summary.map(cliRecord).filter((item) => Boolean(item)) : [];
+  for (const item of summaries) {
+    const label = cliString(item.label);
+    const path2 = cliString(item.path);
+    if (names.some((name) => label === name || path2 === name)) return item.value;
+  }
+  return void 0;
+}
+function setupMetricPart(receipts, label, names = [label]) {
+  for (const receipt of receipts) {
+    const value = setupReturnSummaryValue(receipt, names);
+    const valueLabel = cliValueLabel(value);
+    if (valueLabel !== void 0) return `${label}=${valueLabel}`;
+  }
+  return void 0;
+}
+function setupInputReceiptLabel(kind, receipt) {
+  const selector = cliString(receipt.selector);
+  const pointerType = cliString(receipt.pointer_type);
+  const inputDispatch = cliString(receipt.input_dispatch);
+  const key = cliString(receipt.key);
+  return [
+    kind,
+    selector ? markdownInlineCode(selector) : "",
+    pointerType ? markdownInlineCode(pointerType) : "",
+    key ? markdownInlineCode(key) : "",
+    inputDispatch ? `via ${markdownInlineCode(inputDispatch)}` : ""
+  ].filter(Boolean).join(" ");
+}
+function setupCanvasHashChangeLabel(receipts) {
+  const changed = receipts.find((receipt) => cliString(receipt.previous_hash) && cliString(receipt.hash) && receipt.changed === true);
+  if (changed) return `${markdownInlineCode(cliString(changed.previous_hash) || "")} -> ${markdownInlineCode(cliString(changed.hash) || "")}`;
+  const hashes = receipts.map((receipt) => cliString(receipt.hash)).filter((hash) => Boolean(hash));
+  const first = hashes[0];
+  const last = [...hashes].reverse().find((hash) => hash !== first);
+  return first && last ? `${markdownInlineCode(first)} -> ${markdownInlineCode(last)}` : void 0;
+}
+function setupNaturalInputSummaryMarkdown(viewports) {
+  const lines = [];
+  for (const viewport of viewports.slice(0, 8)) {
+    const name = cliString(viewport.name) || "viewport";
+    const inputReceipts = [
+      ...setupReceiptArray(viewport, "drag").map((receipt) => ({ kind: "drag", receipt })),
+      ...setupReceiptArray(viewport, "tap").map((receipt) => ({ kind: "tap", receipt })),
+      ...setupReceiptArray(viewport, "press").map((receipt) => ({ kind: "press", receipt }))
+    ].filter(({ receipt }) => receipt.ok !== false);
+    if (!inputReceipts.length) continue;
+    const valueReceipts = [
+      ...setupReceiptArray(viewport, "window_eval"),
+      ...setupReceiptArray(viewport, "window_call")
+    ].filter((receipt) => receipt.ok !== false);
+    const canvasReceipts = setupReceiptArray(viewport, "canvas_signature").filter((receipt) => receipt.ok !== false);
+    const eventParts = [
+      setupMetricPart(valueReceipts, "pointerDowns"),
+      setupMetricPart(valueReceipts, "pointerMoves"),
+      setupMetricPart(valueReceipts, "pointerUps"),
+      setupMetricPart(valueReceipts, "trustedEvents"),
+      setupMetricPart(valueReceipts, "eventCount")
+    ].filter((part) => Boolean(part));
+    const pixelParts = [
+      setupMetricPart(valueReceipts, "nonWhiteDelta"),
+      setupMetricPart(valueReceipts, "darkDelta")
+    ].filter((part) => Boolean(part));
+    const hashChange = setupCanvasHashChangeLabel(canvasReceipts);
+    if (!eventParts.length && !pixelParts.length && !hashChange) continue;
+    const inputText = inputReceipts.slice(0, 3).map(({ kind, receipt }) => setupInputReceiptLabel(kind, receipt)).join(", ");
+    const parts = [
+      inputText,
+      eventParts.length ? `events ${eventParts.join(", ")}` : "",
+      pixelParts.length ? `pixel deltas ${pixelParts.join(", ")}` : "",
+      hashChange ? `canvas hash ${hashChange}` : ""
+    ].filter(Boolean);
+    lines.push(`- natural input ${name}: ${parts.join("; ")}`);
+  }
+  return lines;
+}
 function balancedSetupReceiptDetails(groups, limit) {
   if (limit <= 0) return [];
   const total = groups.reduce((sum, group) => sum + group.length, 0);
@@ -806,7 +911,10 @@ function profileSetupSummaryMarkdown(result) {
   const rangeValueTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.set_range_value_total) || 0), 0);
   const dragTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.drag_total) || 0), 0);
   const tapTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.tap_total) || 0), 0);
-  const pressTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.press_total) || 0), 0);
+  const keyboardTotal = viewports.reduce((sum, viewport) => {
+    const total = cliFiniteNumber(viewport.keyboard_total);
+    return sum + (total === void 0 ? cliFiniteNumber(viewport.press_total) || 0 : total);
+  }, 0);
   const canvasSignatureTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.canvas_signature_total) || 0), 0);
   const failedTotal = viewports.reduce((sum, viewport) => sum + (Array.isArray(viewport.failed) ? viewport.failed.length : 0), 0);
   const lines = [
@@ -842,12 +950,13 @@ function profileSetupSummaryMarkdown(result) {
   if (tapTotal) {
     lines.push(`- tap: ${tapTotal} action(s)`);
   }
-  if (pressTotal) {
-    lines.push(`- press: ${pressTotal} action(s)`);
+  if (keyboardTotal) {
+    lines.push(`- keyboard: ${keyboardTotal} action(s)`);
   }
   if (canvasSignatureTotal) {
     lines.push(`- canvas_signature: ${canvasSignatureTotal} action(s)`);
   }
+  lines.push(...setupNaturalInputSummaryMarkdown(viewports));
   for (const viewport of viewports.slice(0, 8)) {
     const name = cliString(viewport.name) || "viewport";
     const ok = viewport.ok === false ? "failed" : "ok";
@@ -868,10 +977,10 @@ function profileSetupSummaryMarkdown(result) {
     const rangeValueActions = cliFiniteNumber(viewport.set_range_value_total) || 0;
     const dragActions = cliFiniteNumber(viewport.drag_total) || 0;
     const tapActions = cliFiniteNumber(viewport.tap_total) || 0;
-    const pressActions = cliFiniteNumber(viewport.press_total) || 0;
+    const keyboardActions = cliFiniteNumber(viewport.keyboard_total) ?? cliFiniteNumber(viewport.press_total) ?? 0;
     const canvasSignatureActions = cliFiniteNumber(viewport.canvas_signature_total) || 0;
     const observedPath = cliString(viewport.observed_path);
-    lines.push(`- ${name}: ${ok}, ${resultCount} result(s), ${screenshotCount} setup screenshot(s), ${clicked} click(s)${clickSequenceCount ? `, ${clickSequenceCount} click sequence(s)` : ""}${clickCountActions ? `, ${clickCountActions} click_count action(s)` : ""}${rangeValueActions ? `, ${rangeValueActions} set_range_value action(s)` : ""}${dragActions ? `, ${dragActions} drag action(s)` : ""}${tapActions ? `, ${tapActions} tap action(s)` : ""}${pressActions ? `, ${pressActions} press action(s)` : ""}${canvasSignatureActions ? `, ${canvasSignatureActions} canvas_signature action(s)` : ""}${deterministicRuntimeActions ? `, ${deterministicRuntimeActions} deterministic_runtime action(s)` : ""}${windowCallActions ? `, ${windowCallActions} window_call action(s), ${windowCallStored} stored return(s), ${windowCallCaptured} captured return(s)` : ""}${windowEvalActions ? `, ${windowEvalActions} window_eval action(s), ${windowEvalStored} stored return(s), ${windowEvalCaptured} captured return(s)` : ""}${windowCallUntilActions ? `, ${windowCallUntilActions} window_call_until action(s), ${windowCallUntilCalls} call(s)` : ""}${observedPath ? `, path ${observedPath}` : ""}`);
+    lines.push(`- ${name}: ${ok}, ${resultCount} result(s), ${screenshotCount} setup screenshot(s), ${clicked} click(s)${clickSequenceCount ? `, ${clickSequenceCount} click sequence(s)` : ""}${clickCountActions ? `, ${clickCountActions} click_count action(s)` : ""}${rangeValueActions ? `, ${rangeValueActions} set_range_value action(s)` : ""}${dragActions ? `, ${dragActions} drag action(s)` : ""}${tapActions ? `, ${tapActions} tap action(s)` : ""}${keyboardActions ? `, ${keyboardActions} keyboard action(s)` : ""}${canvasSignatureActions ? `, ${canvasSignatureActions} canvas_signature action(s)` : ""}${deterministicRuntimeActions ? `, ${deterministicRuntimeActions} deterministic_runtime action(s)` : ""}${windowCallActions ? `, ${windowCallActions} window_call action(s), ${windowCallStored} stored return(s), ${windowCallCaptured} captured return(s)` : ""}${windowEvalActions ? `, ${windowEvalActions} window_eval action(s), ${windowEvalStored} stored return(s), ${windowEvalCaptured} captured return(s)` : ""}${windowCallUntilActions ? `, ${windowCallUntilActions} window_call_until action(s), ${windowCallUntilCalls} call(s)` : ""}${observedPath ? `, path ${observedPath}` : ""}`);
   }
   const clickSequenceGroups = viewports.map((viewport) => {
     const name = cliString(viewport.name) || "viewport";
@@ -938,13 +1047,14 @@ function profileSetupSummaryMarkdown(result) {
     lines.push(`- ${name} tap: ${ok}, ${markdownInlineCode(selector)}${pointerType ? ` ${markdownInlineCode(pointerType)}` : ""}${inputDispatch ? ` via ${markdownInlineCode(inputDispatch)}` : ""}${coordinateText}${durationMs === void 0 ? "" : `, duration ${durationMs}ms`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
   }
   if (tapDetails.length > sampledTapDetails.length) lines.push(`- ${tapDetails.length - sampledTapDetails.length} additional tap receipt(s) omitted.`);
-  const pressGroups = viewports.map((viewport) => {
+  const keyboardGroups = viewports.map((viewport) => {
     const name = cliString(viewport.name) || "viewport";
-    const receipts = Array.isArray(viewport.press) ? viewport.press.map(cliRecord).filter((item) => Boolean(item)) : [];
+    const rawReceipts = Array.isArray(viewport.keyboard) ? viewport.keyboard : viewport.press;
+    const receipts = Array.isArray(rawReceipts) ? rawReceipts.map(cliRecord).filter((item) => Boolean(item)) : [];
     return receipts.map((receipt) => ({ name, receipt }));
   });
-  const pressDetails = pressGroups.flat();
-  for (const group of pressGroups.slice(0, 8)) {
+  const keyboardDetails = keyboardGroups.flat();
+  for (const group of keyboardGroups.slice(0, 8)) {
     if (!group.length) continue;
     const name = group[0].name;
     const keys = group.map(({ receipt }) => cliString(receipt.key) || "key").filter(Boolean);
@@ -955,19 +1065,20 @@ function profileSetupSummaryMarkdown(result) {
     const omittedOrdinalCount = Math.max(0, ordinals.length - visibleOrdinals.length);
     const keyText = visibleKeys.join(",");
     const ordinalText = visibleOrdinals.join(",");
-    lines.push(`- ${name} press_sequence: keys ${markdownInlineCode(keyText, 200)}${omittedKeyCount ? ` (+${omittedKeyCount} omitted)` : ""}${ordinalText ? `, ordinals ${markdownInlineCode(ordinalText, 120)}${omittedOrdinalCount ? ` (+${omittedOrdinalCount} omitted)` : ""}` : ""}`);
+    lines.push(`- ${name} keyboard_sequence: keys ${markdownInlineCode(keyText, 200)}${omittedKeyCount ? ` (+${omittedKeyCount} omitted)` : ""}${ordinalText ? `, ordinals ${markdownInlineCode(ordinalText, 120)}${omittedOrdinalCount ? ` (+${omittedOrdinalCount} omitted)` : ""}` : ""}`);
   }
-  const sampledPressDetails = balancedSetupReceiptDetails(pressGroups, 12);
-  for (const { name, receipt } of sampledPressDetails) {
+  const sampledKeyboardDetails = balancedSetupReceiptDetails(keyboardGroups, 12);
+  for (const { name, receipt } of sampledKeyboardDetails) {
+    const action = cliString(receipt.action) || "press";
     const key = cliString(receipt.key) || "key";
     const selector = cliString(receipt.selector);
     const frameSelector = cliString(receipt.frame_selector);
     const holdMs = cliFiniteNumber(receipt.hold_ms);
     const ok = receipt.ok === false ? "failed" : "ok";
     const reason = cliString(receipt.reason);
-    lines.push(`- ${name} press: ${ok}, ${markdownInlineCode(key)}${selector ? ` on ${markdownInlineCode(selector)}` : ""}${frameSelector ? ` in frame ${markdownInlineCode(frameSelector)}` : ""}${holdMs === void 0 ? "" : `, held ${holdMs}ms`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
+    lines.push(`- ${name} ${action}: ${ok}, ${markdownInlineCode(key)}${selector ? ` on ${markdownInlineCode(selector)}` : ""}${frameSelector ? ` in frame ${markdownInlineCode(frameSelector)}` : ""}${holdMs === void 0 ? "" : `, held ${holdMs}ms`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
   }
-  if (pressDetails.length > sampledPressDetails.length) lines.push(`- ${pressDetails.length - sampledPressDetails.length} additional press receipt(s) omitted.`);
+  if (keyboardDetails.length > sampledKeyboardDetails.length) lines.push(`- ${keyboardDetails.length - sampledKeyboardDetails.length} additional keyboard receipt(s) omitted.`);
   const canvasSignatureGroups = viewports.map((viewport) => {
     const name = cliString(viewport.name) || "viewport";
     const receipts = Array.isArray(viewport.canvas_signature) ? viewport.canvas_signature.map(cliRecord).filter((item) => Boolean(item)) : [];
@@ -1128,7 +1239,11 @@ function profileSetupSummaryMarkdown(result) {
     const selector = cliString(failure.selector);
     const reason = cliString(failure.reason);
     const caseInsensitiveText = cliString(failure.case_insensitive_text);
+    const obstruction = setupFailureObstructionSnippet(reason);
     lines.push(`- failed ${name}: ${action}${selector ? ` ${markdownInlineCode(selector)}` : ""}${reason ? ` reason ${markdownInlineCode(reason)}` : ""}${caseInsensitiveText ? `; case-insensitive sample ${markdownInlineCode(caseInsensitiveText, 140)}` : ""}`);
+    if (obstruction) {
+      lines.push(`- obstruction ${name}: target ${selector ? markdownInlineCode(selector) : markdownInlineCode(action)} intercepted by ${markdownInlineCode(obstruction, 120)}`);
+    }
   }
   if (failedDetails.length > 8) lines.push(`- ${failedDetails.length - 8} additional failed setup action(s) omitted.`);
   if (viewports.length > 8) lines.push(`- ${viewports.length - 8} additional viewport(s) omitted from setup summary.`);

package/dist/index.cjs CHANGED Viewed

@@ -8780,6 +8780,8 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "tap",
   "drag",
   "press",
+  "key_down",
+  "key_up",
   "fill",
   "set_input_value",
   "set_range_value",
@@ -9344,8 +9346,9 @@ function profileSetupTapReceipts(results) {
     reason: result.reason ?? result.error ?? null
   }));
 }
-function profileSetupPressReceipts(results) {
-  return results.filter((result) => profileSetupResultAction(result) === "press").map((result) => ({
+function profileSetupKeyboardReceipts(results) {
+  return results.filter((result) => ["press", "key_down", "key_up"].includes(profileSetupResultAction(result))).map((result) => ({
+    action: profileSetupResultAction(result),
     ordinal: result.ordinal ?? null,
     ok: result.ok !== false,
     selector: result.selector ?? null,
@@ -9518,8 +9521,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
       const sampledDragReceipts = sampleProfileSetupSummaryItems(dragReceipts, 8);
       const tapReceipts = profileSetupTapReceipts(results);
       const sampledTapReceipts = sampleProfileSetupSummaryItems(tapReceipts, 8);
-      const pressReceipts = profileSetupPressReceipts(results);
-      const sampledPressReceipts = sampleProfileSetupSummaryItems(pressReceipts, 8);
+      const keyboardReceipts = profileSetupKeyboardReceipts(results);
+      const sampledKeyboardReceipts = sampleProfileSetupSummaryItems(keyboardReceipts, 8);
       const canvasSignatureReceipts = profileSetupCanvasSignatureReceipts(results);
       const sampledCanvasSignatureReceipts = sampleProfileSetupSummaryItems(canvasSignatureReceipts, 8);
       const clickedItems = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => {
@@ -9587,9 +9590,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
         tap_total: tapReceipts.length,
         tap_truncated: tapReceipts.length > sampledTapReceipts.length,
         tap: sampledTapReceipts,
-        press_total: pressReceipts.length,
-        press_truncated: pressReceipts.length > sampledPressReceipts.length,
-        press: sampledPressReceipts,
+        keyboard_total: keyboardReceipts.length,
+        keyboard_truncated: keyboardReceipts.length > sampledKeyboardReceipts.length,
+        keyboard: sampledKeyboardReceipts,
         canvas_signature_total: canvasSignatureReceipts.length,
         canvas_signature_truncated: canvasSignatureReceipts.length > sampledCanvasSignatureReceipts.length,
         canvas_signature: sampledCanvasSignatureReceipts,
@@ -9646,7 +9649,7 @@ function isSupportedCheckType(value) {
 }
 function normalizeSetupActionType(value, index) {
   const normalizedInput = String(value || "").trim().replace(/-/g, "_");
-  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "reset_console" || normalizedInput === "clear_browser_console" || normalizedInput === "reset_browser_console" ? "clear_console" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "pointer_tap" || normalizedInput === "touch_tap" || normalizedInput === "canvas_tap" ? "tap" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput === "set_slider_value" || normalizedInput === "slider_value" || normalizedInput === "set_slider" || normalizedInput === "set_range" || normalizedInput === "range_value" || normalizedInput === "range_input" || normalizedInput === "set_range_input" ? "set_range_value" : normalizedInput === "deterministic_runtime" || normalizedInput === "mock_runtime" || normalizedInput === "mock_random" || normalizedInput === "mock_random_queue" || normalizedInput === "seed_random_queue" || normalizedInput === "set_random_queue" || normalizedInput === "mock_clock" || normalizedInput === "set_mock_clock" || normalizedInput === "set_runtime_determinism" || normalizedInput === "runtime_determinism" ? "deterministic_runtime" : normalizedInput === "canvas_hash" || normalizedInput === "capture_canvas_hash" || normalizedInput === "capture_canvas_signature" || normalizedInput === "canvas_state_signature" ? "canvas_signature" : normalizedInput === "capture_screenshot" || normalizedInput === "save_screenshot" || normalizedInput === "setup_screenshot" ? "screenshot" : normalizedInput === "accept_dialog" || normalizedInput === "accept_dialogs" || normalizedInput === "confirm_dialog" || normalizedInput === "set_dialog_response" ? "dialog_response" : normalizedInput === "dismiss_dialog" || normalizedInput === "dismiss_dialogs" || normalizedInput === "cancel_dialog" ? "dialog_response" : normalizedInput === "window_call_until" || normalizedInput === "call_until" || normalizedInput === "window_call_repeat_until" || normalizedInput === "repeat_window_call_until" ? "window_call_until" : normalizedInput === "window_evaluate" || normalizedInput === "browser_eval" || normalizedInput === "browser_evaluate" || normalizedInput === "evaluate_script" || normalizedInput === "profile_script" ? "window_eval" : normalizedInput;
+  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "reset_console" || normalizedInput === "clear_browser_console" || normalizedInput === "reset_browser_console" ? "clear_console" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "pointer_tap" || normalizedInput === "touch_tap" || normalizedInput === "canvas_tap" ? "tap" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput === "keyboard_down" || normalizedInput === "key_down" || normalizedInput === "keydown" || normalizedInput === "press_down" ? "key_down" : normalizedInput === "keyboard_up" || normalizedInput === "key_up" || normalizedInput === "keyup" || normalizedInput === "press_up" || normalizedInput === "release_key" || normalizedInput === "key_release" ? "key_up" : normalizedInput === "set_slider_value" || normalizedInput === "slider_value" || normalizedInput === "set_slider" || normalizedInput === "set_range" || normalizedInput === "range_value" || normalizedInput === "range_input" || normalizedInput === "set_range_input" ? "set_range_value" : normalizedInput === "deterministic_runtime" || normalizedInput === "mock_runtime" || normalizedInput === "mock_random" || normalizedInput === "mock_random_queue" || normalizedInput === "seed_random_queue" || normalizedInput === "set_random_queue" || normalizedInput === "mock_clock" || normalizedInput === "set_mock_clock" || normalizedInput === "set_runtime_determinism" || normalizedInput === "runtime_determinism" ? "deterministic_runtime" : normalizedInput === "canvas_hash" || normalizedInput === "capture_canvas_hash" || normalizedInput === "capture_canvas_signature" || normalizedInput === "canvas_state_signature" ? "canvas_signature" : normalizedInput === "capture_screenshot" || normalizedInput === "save_screenshot" || normalizedInput === "setup_screenshot" ? "screenshot" : normalizedInput === "accept_dialog" || normalizedInput === "accept_dialogs" || normalizedInput === "confirm_dialog" || normalizedInput === "set_dialog_response" ? "dialog_response" : normalizedInput === "dismiss_dialog" || normalizedInput === "dismiss_dialogs" || normalizedInput === "cancel_dialog" ? "dialog_response" : normalizedInput === "window_call_until" || normalizedInput === "call_until" || normalizedInput === "window_call_repeat_until" || normalizedInput === "repeat_window_call_until" ? "window_call_until" : normalizedInput === "window_evaluate" || normalizedInput === "browser_eval" || normalizedInput === "browser_evaluate" || normalizedInput === "evaluate_script" || normalizedInput === "profile_script" ? "window_eval" : normalizedInput;
   if (RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.includes(normalized)) {
     return normalized;
   }
@@ -9902,7 +9905,7 @@ function normalizeSetupAction(input, index) {
       dialogAccept = true;
     }
   }
-  if (type === "press" && !key) {
+  if ((type === "press" || type === "key_down" || type === "key_up") && !key) {
     throw new Error(`target.setup_actions[${index}] ${type} requires key.`);
   }
   if ((type === "local_storage" || type === "session_storage") && !key) {
@@ -13227,10 +13230,11 @@ function profileSetupTapReceipts(results) {
       reason: result.reason || result.error || null,
     }));
 }
-function profileSetupPressReceipts(results) {
+function profileSetupKeyboardReceipts(results) {
   return (results || [])
-    .filter((result) => result && profileSetupResultAction(result) === "press")
+    .filter((result) => result && ["press", "key_down", "key_up"].includes(profileSetupResultAction(result)))
     .map((result) => ({
+      action: profileSetupResultAction(result),
       ordinal: result.ordinal ?? null,
       ok: result.ok !== false,
       selector: result.selector ?? null,
@@ -13428,8 +13432,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
       const sampledDragReceipts = sampleProfileSetupSummaryItems(dragReceipts, 8);
       const tapReceipts = profileSetupTapReceipts(results);
       const sampledTapReceipts = sampleProfileSetupSummaryItems(tapReceipts, 8);
-      const pressReceipts = profileSetupPressReceipts(results);
-      const sampledPressReceipts = sampleProfileSetupSummaryItems(pressReceipts, 8);
+      const keyboardReceipts = profileSetupKeyboardReceipts(results);
+      const sampledKeyboardReceipts = sampleProfileSetupSummaryItems(keyboardReceipts, 8);
       const canvasSignatureReceipts = profileSetupCanvasSignatureReceipts(results);
       const sampledCanvasSignatureReceipts = sampleProfileSetupSummaryItems(canvasSignatureReceipts, 8);
       const clickedItems = results
@@ -13507,9 +13511,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         tap_total: tapReceipts.length,
         tap_truncated: tapReceipts.length > sampledTapReceipts.length,
         tap: sampledTapReceipts,
-        press_total: pressReceipts.length,
-        press_truncated: pressReceipts.length > sampledPressReceipts.length,
-        press: sampledPressReceipts,
+        keyboard_total: keyboardReceipts.length,
+        keyboard_truncated: keyboardReceipts.length > sampledKeyboardReceipts.length,
+        keyboard: sampledKeyboardReceipts,
         canvas_signature_total: canvasSignatureReceipts.length,
         canvas_signature_truncated: canvasSignatureReceipts.length > sampledCanvasSignatureReceipts.length,
         canvas_signature: sampledCanvasSignatureReceipts,
@@ -15170,6 +15174,37 @@ async function executeSetupAction(action, ordinal, viewport) {
         duration_ms: durationMs || undefined,
       };
     }
+    if (type === "key_down" || type === "key_up") {
+      const key = String(action.key || "").trim();
+      if (!key) return { ...base, reason: "missing_key" };
+      const scope = await setupActionScope(action, timeout);
+      if (!scope.ok) return setupScopeFailure(base, scope);
+      let count;
+      let targetIndex;
+      if (action.selector) {
+        const locator = scope.context.locator(action.selector);
+        count = await locator.count();
+        if (!count) return { ...base, reason: "selector_not_found", count, key };
+        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).focus({ timeout }).catch(() => {});
+      } else if (scope.frame_selector) {
+        await scope.context.locator("body").focus({ timeout }).catch(() => {});
+      }
+      if (type === "key_down") {
+        await page.keyboard.down(key);
+      } else {
+        await page.keyboard.up(key);
+      }
+      return {
+        ...base,
+        ...setupScopeEvidence(scope),
+        ok: true,
+        count,
+        target_index: targetIndex,
+        key,
+      };
+    }
     if (type === "press") {
       const key = String(action.key || "").trim();
       if (!key) return { ...base, reason: "missing_key" };

package/dist/index.js CHANGED Viewed

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

package/dist/profile.cjs CHANGED Viewed

@@ -94,6 +94,8 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "tap",
   "drag",
   "press",
+  "key_down",
+  "key_up",
   "fill",
   "set_input_value",
   "set_range_value",
@@ -658,8 +660,9 @@ function profileSetupTapReceipts(results) {
     reason: result.reason ?? result.error ?? null
   }));
 }
-function profileSetupPressReceipts(results) {
-  return results.filter((result) => profileSetupResultAction(result) === "press").map((result) => ({
+function profileSetupKeyboardReceipts(results) {
+  return results.filter((result) => ["press", "key_down", "key_up"].includes(profileSetupResultAction(result))).map((result) => ({
+    action: profileSetupResultAction(result),
     ordinal: result.ordinal ?? null,
     ok: result.ok !== false,
     selector: result.selector ?? null,
@@ -832,8 +835,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
       const sampledDragReceipts = sampleProfileSetupSummaryItems(dragReceipts, 8);
       const tapReceipts = profileSetupTapReceipts(results);
       const sampledTapReceipts = sampleProfileSetupSummaryItems(tapReceipts, 8);
-      const pressReceipts = profileSetupPressReceipts(results);
-      const sampledPressReceipts = sampleProfileSetupSummaryItems(pressReceipts, 8);
+      const keyboardReceipts = profileSetupKeyboardReceipts(results);
+      const sampledKeyboardReceipts = sampleProfileSetupSummaryItems(keyboardReceipts, 8);
       const canvasSignatureReceipts = profileSetupCanvasSignatureReceipts(results);
       const sampledCanvasSignatureReceipts = sampleProfileSetupSummaryItems(canvasSignatureReceipts, 8);
       const clickedItems = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => {
@@ -901,9 +904,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
         tap_total: tapReceipts.length,
         tap_truncated: tapReceipts.length > sampledTapReceipts.length,
         tap: sampledTapReceipts,
-        press_total: pressReceipts.length,
-        press_truncated: pressReceipts.length > sampledPressReceipts.length,
-        press: sampledPressReceipts,
+        keyboard_total: keyboardReceipts.length,
+        keyboard_truncated: keyboardReceipts.length > sampledKeyboardReceipts.length,
+        keyboard: sampledKeyboardReceipts,
         canvas_signature_total: canvasSignatureReceipts.length,
         canvas_signature_truncated: canvasSignatureReceipts.length > sampledCanvasSignatureReceipts.length,
         canvas_signature: sampledCanvasSignatureReceipts,
@@ -960,7 +963,7 @@ function isSupportedCheckType(value) {
 }
 function normalizeSetupActionType(value, index) {
   const normalizedInput = String(value || "").trim().replace(/-/g, "_");
-  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "reset_console" || normalizedInput === "clear_browser_console" || normalizedInput === "reset_browser_console" ? "clear_console" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "pointer_tap" || normalizedInput === "touch_tap" || normalizedInput === "canvas_tap" ? "tap" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput === "set_slider_value" || normalizedInput === "slider_value" || normalizedInput === "set_slider" || normalizedInput === "set_range" || normalizedInput === "range_value" || normalizedInput === "range_input" || normalizedInput === "set_range_input" ? "set_range_value" : normalizedInput === "deterministic_runtime" || normalizedInput === "mock_runtime" || normalizedInput === "mock_random" || normalizedInput === "mock_random_queue" || normalizedInput === "seed_random_queue" || normalizedInput === "set_random_queue" || normalizedInput === "mock_clock" || normalizedInput === "set_mock_clock" || normalizedInput === "set_runtime_determinism" || normalizedInput === "runtime_determinism" ? "deterministic_runtime" : normalizedInput === "canvas_hash" || normalizedInput === "capture_canvas_hash" || normalizedInput === "capture_canvas_signature" || normalizedInput === "canvas_state_signature" ? "canvas_signature" : normalizedInput === "capture_screenshot" || normalizedInput === "save_screenshot" || normalizedInput === "setup_screenshot" ? "screenshot" : normalizedInput === "accept_dialog" || normalizedInput === "accept_dialogs" || normalizedInput === "confirm_dialog" || normalizedInput === "set_dialog_response" ? "dialog_response" : normalizedInput === "dismiss_dialog" || normalizedInput === "dismiss_dialogs" || normalizedInput === "cancel_dialog" ? "dialog_response" : normalizedInput === "window_call_until" || normalizedInput === "call_until" || normalizedInput === "window_call_repeat_until" || normalizedInput === "repeat_window_call_until" ? "window_call_until" : normalizedInput === "window_evaluate" || normalizedInput === "browser_eval" || normalizedInput === "browser_evaluate" || normalizedInput === "evaluate_script" || normalizedInput === "profile_script" ? "window_eval" : normalizedInput;
+  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "reset_console" || normalizedInput === "clear_browser_console" || normalizedInput === "reset_browser_console" ? "clear_console" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "pointer_tap" || normalizedInput === "touch_tap" || normalizedInput === "canvas_tap" ? "tap" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput === "keyboard_down" || normalizedInput === "key_down" || normalizedInput === "keydown" || normalizedInput === "press_down" ? "key_down" : normalizedInput === "keyboard_up" || normalizedInput === "key_up" || normalizedInput === "keyup" || normalizedInput === "press_up" || normalizedInput === "release_key" || normalizedInput === "key_release" ? "key_up" : normalizedInput === "set_slider_value" || normalizedInput === "slider_value" || normalizedInput === "set_slider" || normalizedInput === "set_range" || normalizedInput === "range_value" || normalizedInput === "range_input" || normalizedInput === "set_range_input" ? "set_range_value" : normalizedInput === "deterministic_runtime" || normalizedInput === "mock_runtime" || normalizedInput === "mock_random" || normalizedInput === "mock_random_queue" || normalizedInput === "seed_random_queue" || normalizedInput === "set_random_queue" || normalizedInput === "mock_clock" || normalizedInput === "set_mock_clock" || normalizedInput === "set_runtime_determinism" || normalizedInput === "runtime_determinism" ? "deterministic_runtime" : normalizedInput === "canvas_hash" || normalizedInput === "capture_canvas_hash" || normalizedInput === "capture_canvas_signature" || normalizedInput === "canvas_state_signature" ? "canvas_signature" : normalizedInput === "capture_screenshot" || normalizedInput === "save_screenshot" || normalizedInput === "setup_screenshot" ? "screenshot" : normalizedInput === "accept_dialog" || normalizedInput === "accept_dialogs" || normalizedInput === "confirm_dialog" || normalizedInput === "set_dialog_response" ? "dialog_response" : normalizedInput === "dismiss_dialog" || normalizedInput === "dismiss_dialogs" || normalizedInput === "cancel_dialog" ? "dialog_response" : normalizedInput === "window_call_until" || normalizedInput === "call_until" || normalizedInput === "window_call_repeat_until" || normalizedInput === "repeat_window_call_until" ? "window_call_until" : normalizedInput === "window_evaluate" || normalizedInput === "browser_eval" || normalizedInput === "browser_evaluate" || normalizedInput === "evaluate_script" || normalizedInput === "profile_script" ? "window_eval" : normalizedInput;
   if (RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.includes(normalized)) {
     return normalized;
   }
@@ -1216,7 +1219,7 @@ function normalizeSetupAction(input, index) {
       dialogAccept = true;
     }
   }
-  if (type === "press" && !key) {
+  if ((type === "press" || type === "key_down" || type === "key_up") && !key) {
     throw new Error(`target.setup_actions[${index}] ${type} requires key.`);
   }
   if ((type === "local_storage" || type === "session_storage") && !key) {
@@ -4541,10 +4544,11 @@ function profileSetupTapReceipts(results) {
       reason: result.reason || result.error || null,
     }));
 }
-function profileSetupPressReceipts(results) {
+function profileSetupKeyboardReceipts(results) {
   return (results || [])
-    .filter((result) => result && profileSetupResultAction(result) === "press")
+    .filter((result) => result && ["press", "key_down", "key_up"].includes(profileSetupResultAction(result)))
     .map((result) => ({
+      action: profileSetupResultAction(result),
       ordinal: result.ordinal ?? null,
       ok: result.ok !== false,
       selector: result.selector ?? null,
@@ -4742,8 +4746,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
       const sampledDragReceipts = sampleProfileSetupSummaryItems(dragReceipts, 8);
       const tapReceipts = profileSetupTapReceipts(results);
       const sampledTapReceipts = sampleProfileSetupSummaryItems(tapReceipts, 8);
-      const pressReceipts = profileSetupPressReceipts(results);
-      const sampledPressReceipts = sampleProfileSetupSummaryItems(pressReceipts, 8);
+      const keyboardReceipts = profileSetupKeyboardReceipts(results);
+      const sampledKeyboardReceipts = sampleProfileSetupSummaryItems(keyboardReceipts, 8);
       const canvasSignatureReceipts = profileSetupCanvasSignatureReceipts(results);
       const sampledCanvasSignatureReceipts = sampleProfileSetupSummaryItems(canvasSignatureReceipts, 8);
       const clickedItems = results
@@ -4821,9 +4825,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         tap_total: tapReceipts.length,
         tap_truncated: tapReceipts.length > sampledTapReceipts.length,
         tap: sampledTapReceipts,
-        press_total: pressReceipts.length,
-        press_truncated: pressReceipts.length > sampledPressReceipts.length,
-        press: sampledPressReceipts,
+        keyboard_total: keyboardReceipts.length,
+        keyboard_truncated: keyboardReceipts.length > sampledKeyboardReceipts.length,
+        keyboard: sampledKeyboardReceipts,
         canvas_signature_total: canvasSignatureReceipts.length,
         canvas_signature_truncated: canvasSignatureReceipts.length > sampledCanvasSignatureReceipts.length,
         canvas_signature: sampledCanvasSignatureReceipts,
@@ -6484,6 +6488,37 @@ async function executeSetupAction(action, ordinal, viewport) {
         duration_ms: durationMs || undefined,
       };
     }
+    if (type === "key_down" || type === "key_up") {
+      const key = String(action.key || "").trim();
+      if (!key) return { ...base, reason: "missing_key" };
+      const scope = await setupActionScope(action, timeout);
+      if (!scope.ok) return setupScopeFailure(base, scope);
+      let count;
+      let targetIndex;
+      if (action.selector) {
+        const locator = scope.context.locator(action.selector);
+        count = await locator.count();
+        if (!count) return { ...base, reason: "selector_not_found", count, key };
+        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).focus({ timeout }).catch(() => {});
+      } else if (scope.frame_selector) {
+        await scope.context.locator("body").focus({ timeout }).catch(() => {});
+      }
+      if (type === "key_down") {
+        await page.keyboard.down(key);
+      } else {
+        await page.keyboard.up(key);
+      }
+      return {
+        ...base,
+        ...setupScopeEvidence(scope),
+        ok: true,
+        count,
+        target_index: targetIndex,
+        key,
+      };
+    }
     if (type === "press") {
       const key = String(action.key || "").trim();
       if (!key) return { ...base, reason: "missing_key" };

package/dist/profile.d.cts CHANGED Viewed

@@ -5,7 +5,7 @@ declare const RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION: "riddle-proof.profile-evide
 declare const RIDDLE_PROOF_PROFILE_RESULT_VERSION: "riddle-proof.profile-result.v1";
 declare const RIDDLE_PROOF_PROFILE_STATUSES: readonly ["passed", "product_regression", "proof_insufficient", "environment_blocked", "configuration_error", "needs_human_review"];
 declare const RIDDLE_PROOF_PROFILE_CHECK_TYPES: readonly ["route_loaded", "url_search_param_equals", "url_search_param_absent", "selector_visible", "selector_absent", "selector_count_at_least", "selector_count_equals", "selector_count_equal", "selector_count_eq", "dialog_count_equals", "dialog_accept_count_equals", "dialog_dismiss_count_equals", "selector_text_visible", "selector_text_absent", "selector_text_order", "observe_within", "frame_text_visible", "frame_url_equals", "frame_url_matches", "frame_no_horizontal_overflow", "text_visible", "text_absent", "http_status", "link_status", "artifact_link_status", "route_inventory", "no_horizontal_overflow", "no_mobile_horizontal_overflow", "no_fatal_console_errors", "no_console_warnings"];
-declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "tap", "drag", "press", "fill", "set_input_value", "set_range_value", "deterministic_runtime", "canvas_signature", "assert_text_visible", "assert_text_absent", "assert_selector_count", "assert_window_value", "assert_window_number", "local_storage", "session_storage", "clear_storage", "clear_console", "dialog_response", "screenshot", "wait", "wait_for_selector", "wait_for_text", "window_eval", "window_call", "window_call_until"];
+declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "tap", "drag", "press", "key_down", "key_up", "fill", "set_input_value", "set_range_value", "deterministic_runtime", "canvas_signature", "assert_text_visible", "assert_text_absent", "assert_selector_count", "assert_window_value", "assert_window_number", "local_storage", "session_storage", "clear_storage", "clear_console", "dialog_response", "screenshot", "wait", "wait_for_selector", "wait_for_text", "window_eval", "window_call", "window_call_until"];
 type RiddleProofProfileStatus = typeof RIDDLE_PROOF_PROFILE_STATUSES[number];
 type RiddleProofProfileCheckType = typeof RIDDLE_PROOF_PROFILE_CHECK_TYPES[number];
 type RiddleProofProfileSetupActionType = typeof RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES[number];

package/dist/profile.d.ts CHANGED Viewed

@@ -5,7 +5,7 @@ declare const RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION: "riddle-proof.profile-evide
 declare const RIDDLE_PROOF_PROFILE_RESULT_VERSION: "riddle-proof.profile-result.v1";
 declare const RIDDLE_PROOF_PROFILE_STATUSES: readonly ["passed", "product_regression", "proof_insufficient", "environment_blocked", "configuration_error", "needs_human_review"];
 declare const RIDDLE_PROOF_PROFILE_CHECK_TYPES: readonly ["route_loaded", "url_search_param_equals", "url_search_param_absent", "selector_visible", "selector_absent", "selector_count_at_least", "selector_count_equals", "selector_count_equal", "selector_count_eq", "dialog_count_equals", "dialog_accept_count_equals", "dialog_dismiss_count_equals", "selector_text_visible", "selector_text_absent", "selector_text_order", "observe_within", "frame_text_visible", "frame_url_equals", "frame_url_matches", "frame_no_horizontal_overflow", "text_visible", "text_absent", "http_status", "link_status", "artifact_link_status", "route_inventory", "no_horizontal_overflow", "no_mobile_horizontal_overflow", "no_fatal_console_errors", "no_console_warnings"];
-declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "tap", "drag", "press", "fill", "set_input_value", "set_range_value", "deterministic_runtime", "canvas_signature", "assert_text_visible", "assert_text_absent", "assert_selector_count", "assert_window_value", "assert_window_number", "local_storage", "session_storage", "clear_storage", "clear_console", "dialog_response", "screenshot", "wait", "wait_for_selector", "wait_for_text", "window_eval", "window_call", "window_call_until"];
+declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "tap", "drag", "press", "key_down", "key_up", "fill", "set_input_value", "set_range_value", "deterministic_runtime", "canvas_signature", "assert_text_visible", "assert_text_absent", "assert_selector_count", "assert_window_value", "assert_window_number", "local_storage", "session_storage", "clear_storage", "clear_console", "dialog_response", "screenshot", "wait", "wait_for_selector", "wait_for_text", "window_eval", "window_call", "window_call_until"];
 type RiddleProofProfileStatus = typeof RIDDLE_PROOF_PROFILE_STATUSES[number];
 type RiddleProofProfileCheckType = typeof RIDDLE_PROOF_PROFILE_CHECK_TYPES[number];
 type RiddleProofProfileSetupActionType = typeof RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES[number];

package/dist/profile.js CHANGED Viewed

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

package/dist/proof-run-core.d.cts CHANGED Viewed

@@ -120,7 +120,7 @@ declare function buildSetupArgs(params: WorkflowParams, config: ReturnType<typeo
     target_image_hash: string;
     viewport_matrix_json: string;
     deterministic_setup_json: string;
-    reference: "before" | "prod" | "both";
+    reference: "prod" | "before" | "both";
     base_branch: string;
     before_ref: string;
     allow_static_preview_fallback: string;

package/dist/proof-run-core.d.ts CHANGED Viewed

@@ -120,7 +120,7 @@ declare function buildSetupArgs(params: WorkflowParams, config: ReturnType<typeo
     target_image_hash: string;
     viewport_matrix_json: string;
     deterministic_setup_json: string;
-    reference: "before" | "prod" | "both";
+    reference: "prod" | "before" | "both";
     base_branch: string;
     before_ref: string;
     allow_static_preview_fallback: string;

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

@@ -292,7 +292,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     blocking?: boolean;
     details?: Record<string, unknown>;
     ok: boolean;
-    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "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: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "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: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
     state_path: string;
     stage: any;
     summary: string;

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

@@ -292,7 +292,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     blocking?: boolean;
     details?: Record<string, unknown>;
     ok: boolean;
-    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "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: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "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: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
     state_path: string;
     stage: any;
     summary: string;

package/package.json CHANGED Viewed

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