@riddledc/riddle-proof 0.7.180 → 0.7.182

package/README.md

@@ -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`,
@@ -417,6 +417,11 @@ stable enough for Playwright's default click actionability checks. Use `press`
 with a Playwright key name, such as `Enter`, `Space`, or `ArrowLeft`,
 when a route's intended browser control is keyboard-driven; omit `selector` for
 a page-level key press, or provide `selector` to press against a focused element.
+For canvas games that read key state rather than keypress events, add `hold_ms`
+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-62JD4MJA.js → chunk-XL7Q4M6D.js}

@@ -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",
@@ -612,12 +614,14 @@ function profileSetupTapReceipts(results) {
   }));
 }
 function profileSetupPressReceipts(results) {
-  return results.filter((result) => profileSetupResultAction(result) === "press").map((result) => ({
+  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,
     frame_selector: result.frame_selector ?? null,
     key: result.key ?? null,
+    hold_ms: result.hold_ms ?? null,
     reason: result.reason ?? result.error ?? null
   }));
 }
@@ -912,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;
   }
@@ -1083,6 +1087,11 @@ function normalizeSetupAction(input, index) {
   const toY = numberValue(valueFromOwn(input, "to_y", "toY", "end_y", "endY", "y2"));
   const coordinateMode = normalizeSetupActionCoordinateMode(valueFromOwn(input, "coordinate_mode", "coordinateMode", "coords", "units"), index);
   const pointerType = normalizeSetupActionPointerType(valueFromOwn(input, "pointer_type", "pointerType", "input_type", "inputType"), type, index);
+  const durationMs = numberValue(input.duration_ms) ?? numberValue(input.durationMs);
+  const holdMs = type === "press" ? normalizeSetupActionNonNegativeNumber(input, index, "hold_ms", "hold_ms", "holdMs", "key_down_ms", "keyDownMs", "down_ms", "downMs") ?? durationMs : void 0;
+  if (type === "press" && holdMs !== void 0 && (holdMs < 0 || holdMs > 3e4)) {
+    throw new Error(`target.setup_actions[${index}].hold_ms must be a finite number from 0 to 30000.`);
+  }
   if (type === "click") {
     const hasClickCoordinate = fromX !== void 0 || fromY !== void 0;
     if (hasClickCoordinate && (fromX === void 0 || fromY === void 0)) {
@@ -1163,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) {
@@ -1249,9 +1258,10 @@ function normalizeSetupAction(input, index) {
     from_y: fromY,
     to_x: toX,
     to_y: toY,
-    duration_ms: numberValue(input.duration_ms) ?? numberValue(input.durationMs),
+    duration_ms: durationMs,
     steps,
     key,
+    hold_ms: holdMs,
     value,
     value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
     random_queue: randomQueue,
@@ -4489,13 +4499,15 @@ function profileSetupTapReceipts(results) {
 }
 function profileSetupPressReceipts(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,
       frame_selector: result.frame_selector ?? null,
       key: result.key ?? null,
+      hold_ms: result.hold_ms ?? null,
       reason: result.reason || result.error || null,
     }));
 }
@@ -6429,12 +6441,56 @@ 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" };
+      const holdMs = Math.min(30000, Math.max(0, Math.floor(setupNumber(action.hold_ms ?? action.holdMs ?? action.key_down_ms ?? action.keyDownMs ?? action.down_ms ?? action.downMs ?? action.duration_ms ?? action.durationMs, 0) || 0)));
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
       if (!action.selector) {
+        if (holdMs > 0) {
+          if (scope.frame_selector) {
+            await scope.context.locator("body").focus({ timeout }).catch(() => {});
+          }
+          await page.keyboard.down(key);
+          try {
+            await page.waitForTimeout(holdMs);
+          } finally {
+            await page.keyboard.up(key).catch(() => {});
+          }
+          return { ...base, ...setupScopeEvidence(scope), ok: true, key, hold_ms: holdMs };
+        }
         if (scope.frame_selector) {
           await scope.context.locator("body").press(key, { timeout });
         } else {
@@ -6447,6 +6503,16 @@ async function executeSetupAction(action, ordinal, viewport) {
       if (!count) return { ...base, reason: "selector_not_found", count, key };
       const targetIndex = Number.isInteger(action.index) ? action.index : 0;
       if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex, key };
+      if (holdMs > 0) {
+        await locator.nth(targetIndex).focus({ timeout });
+        await page.keyboard.down(key);
+        try {
+          await page.waitForTimeout(holdMs);
+        } finally {
+          await page.keyboard.up(key).catch(() => {});
+        }
+        return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, key, hold_ms: holdMs };
+      }
       await locator.nth(targetIndex).press(key, { timeout });
       return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, key };
     }

package/dist/cli.cjs

@@ -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",
@@ -7569,12 +7571,14 @@ function profileSetupTapReceipts(results) {
   }));
 }
 function profileSetupPressReceipts(results) {
-  return results.filter((result) => profileSetupResultAction(result) === "press").map((result) => ({
+  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,
     frame_selector: result.frame_selector ?? null,
     key: result.key ?? null,
+    hold_ms: result.hold_ms ?? null,
     reason: result.reason ?? result.error ?? null
   }));
 }
@@ -7869,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;
   }
@@ -8040,6 +8044,11 @@ function normalizeSetupAction(input, index) {
   const toY = numberValue(valueFromOwn(input, "to_y", "toY", "end_y", "endY", "y2"));
   const coordinateMode = normalizeSetupActionCoordinateMode(valueFromOwn(input, "coordinate_mode", "coordinateMode", "coords", "units"), index);
   const pointerType = normalizeSetupActionPointerType(valueFromOwn(input, "pointer_type", "pointerType", "input_type", "inputType"), type, index);
+  const durationMs = numberValue(input.duration_ms) ?? numberValue(input.durationMs);
+  const holdMs = type === "press" ? normalizeSetupActionNonNegativeNumber(input, index, "hold_ms", "hold_ms", "holdMs", "key_down_ms", "keyDownMs", "down_ms", "downMs") ?? durationMs : void 0;
+  if (type === "press" && holdMs !== void 0 && (holdMs < 0 || holdMs > 3e4)) {
+    throw new Error(`target.setup_actions[${index}].hold_ms must be a finite number from 0 to 30000.`);
+  }
   if (type === "click") {
     const hasClickCoordinate = fromX !== void 0 || fromY !== void 0;
     if (hasClickCoordinate && (fromX === void 0 || fromY === void 0)) {
@@ -8120,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) {
@@ -8206,9 +8215,10 @@ function normalizeSetupAction(input, index) {
     from_y: fromY,
     to_x: toX,
     to_y: toY,
-    duration_ms: numberValue(input.duration_ms) ?? numberValue(input.durationMs),
+    duration_ms: durationMs,
     steps,
     key,
+    hold_ms: holdMs,
     value,
     value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
     random_queue: randomQueue,
@@ -11430,13 +11440,15 @@ function profileSetupTapReceipts(results) {
 }
 function profileSetupPressReceipts(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,
       frame_selector: result.frame_selector ?? null,
       key: result.key ?? null,
+      hold_ms: result.hold_ms ?? null,
       reason: result.reason || result.error || null,
     }));
 }
@@ -13370,12 +13382,56 @@ 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" };
+      const holdMs = Math.min(30000, Math.max(0, Math.floor(setupNumber(action.hold_ms ?? action.holdMs ?? action.key_down_ms ?? action.keyDownMs ?? action.down_ms ?? action.downMs ?? action.duration_ms ?? action.durationMs, 0) || 0)));
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
       if (!action.selector) {
+        if (holdMs > 0) {
+          if (scope.frame_selector) {
+            await scope.context.locator("body").focus({ timeout }).catch(() => {});
+          }
+          await page.keyboard.down(key);
+          try {
+            await page.waitForTimeout(holdMs);
+          } finally {
+            await page.keyboard.up(key).catch(() => {});
+          }
+          return { ...base, ...setupScopeEvidence(scope), ok: true, key, hold_ms: holdMs };
+        }
         if (scope.frame_selector) {
           await scope.context.locator("body").press(key, { timeout });
         } else {
@@ -13388,6 +13444,16 @@ async function executeSetupAction(action, ordinal, viewport) {
       if (!count) return { ...base, reason: "selector_not_found", count, key };
       const targetIndex = Number.isInteger(action.index) ? action.index : 0;
       if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex, key };
+      if (holdMs > 0) {
+        await locator.nth(targetIndex).focus({ timeout });
+        await page.keyboard.down(key);
+        try {
+          await page.waitForTimeout(holdMs);
+        } finally {
+          await page.keyboard.up(key).catch(() => {});
+        }
+        return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, key, hold_ms: holdMs };
+      }
       await locator.nth(targetIndex).press(key, { timeout });
       return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, key };
     }
@@ -16339,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;
 }
@@ -16376,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);
@@ -16565,6 +16736,7 @@ function profileSetupSummaryMarkdown(result) {
   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";
@@ -16676,12 +16848,14 @@ function profileSetupSummaryMarkdown(result) {
   }
   const sampledPressDetails = balancedSetupReceiptDetails(pressGroups, 12);
   for (const { name, receipt } of sampledPressDetails) {
+    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)}` : ""}${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.`);
   const canvasSignatureGroups = viewports.map((viewport) => {
@@ -16844,7 +17018,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

@@ -13,7 +13,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-62JD4MJA.js";
+} from "./chunk-XL7Q4M6D.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);
@@ -848,6 +953,7 @@ function profileSetupSummaryMarkdown(result) {
   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";
@@ -959,12 +1065,14 @@ function profileSetupSummaryMarkdown(result) {
   }
   const sampledPressDetails = balancedSetupReceiptDetails(pressGroups, 12);
   for (const { name, receipt } of sampledPressDetails) {
+    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)}` : ""}${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.`);
   const canvasSignatureGroups = viewports.map((viewport) => {
@@ -1127,7 +1235,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

@@ -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",
@@ -9345,12 +9347,14 @@ function profileSetupTapReceipts(results) {
   }));
 }
 function profileSetupPressReceipts(results) {
-  return results.filter((result) => profileSetupResultAction(result) === "press").map((result) => ({
+  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,
     frame_selector: result.frame_selector ?? null,
     key: result.key ?? null,
+    hold_ms: result.hold_ms ?? null,
     reason: result.reason ?? result.error ?? null
   }));
 }
@@ -9645,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;
   }
@@ -9816,6 +9820,11 @@ function normalizeSetupAction(input, index) {
   const toY = numberValue3(valueFromOwn(input, "to_y", "toY", "end_y", "endY", "y2"));
   const coordinateMode = normalizeSetupActionCoordinateMode(valueFromOwn(input, "coordinate_mode", "coordinateMode", "coords", "units"), index);
   const pointerType = normalizeSetupActionPointerType(valueFromOwn(input, "pointer_type", "pointerType", "input_type", "inputType"), type, index);
+  const durationMs = numberValue3(input.duration_ms) ?? numberValue3(input.durationMs);
+  const holdMs = type === "press" ? normalizeSetupActionNonNegativeNumber(input, index, "hold_ms", "hold_ms", "holdMs", "key_down_ms", "keyDownMs", "down_ms", "downMs") ?? durationMs : void 0;
+  if (type === "press" && holdMs !== void 0 && (holdMs < 0 || holdMs > 3e4)) {
+    throw new Error(`target.setup_actions[${index}].hold_ms must be a finite number from 0 to 30000.`);
+  }
   if (type === "click") {
     const hasClickCoordinate = fromX !== void 0 || fromY !== void 0;
     if (hasClickCoordinate && (fromX === void 0 || fromY === void 0)) {
@@ -9896,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) {
@@ -9982,9 +9991,10 @@ function normalizeSetupAction(input, index) {
     from_y: fromY,
     to_x: toX,
     to_y: toY,
-    duration_ms: numberValue3(input.duration_ms) ?? numberValue3(input.durationMs),
+    duration_ms: durationMs,
     steps,
     key,
+    hold_ms: holdMs,
     value,
     value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
     random_queue: randomQueue,
@@ -13222,13 +13232,15 @@ function profileSetupTapReceipts(results) {
 }
 function profileSetupPressReceipts(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,
       frame_selector: result.frame_selector ?? null,
       key: result.key ?? null,
+      hold_ms: result.hold_ms ?? null,
       reason: result.reason || result.error || null,
     }));
 }
@@ -15162,12 +15174,56 @@ 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" };
+      const holdMs = Math.min(30000, Math.max(0, Math.floor(setupNumber(action.hold_ms ?? action.holdMs ?? action.key_down_ms ?? action.keyDownMs ?? action.down_ms ?? action.downMs ?? action.duration_ms ?? action.durationMs, 0) || 0)));
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
       if (!action.selector) {
+        if (holdMs > 0) {
+          if (scope.frame_selector) {
+            await scope.context.locator("body").focus({ timeout }).catch(() => {});
+          }
+          await page.keyboard.down(key);
+          try {
+            await page.waitForTimeout(holdMs);
+          } finally {
+            await page.keyboard.up(key).catch(() => {});
+          }
+          return { ...base, ...setupScopeEvidence(scope), ok: true, key, hold_ms: holdMs };
+        }
         if (scope.frame_selector) {
           await scope.context.locator("body").press(key, { timeout });
         } else {
@@ -15180,6 +15236,16 @@ async function executeSetupAction(action, ordinal, viewport) {
       if (!count) return { ...base, reason: "selector_not_found", count, key };
       const targetIndex = Number.isInteger(action.index) ? action.index : 0;
       if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex, key };
+      if (holdMs > 0) {
+        await locator.nth(targetIndex).focus({ timeout });
+        await page.keyboard.down(key);
+        try {
+          await page.waitForTimeout(holdMs);
+        } finally {
+          await page.keyboard.up(key).catch(() => {});
+        }
+        return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, key, hold_ms: holdMs };
+      }
       await locator.nth(targetIndex).press(key, { timeout });
       return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, key };
     }

package/dist/index.js

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

package/dist/profile.cjs

@@ -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",
@@ -659,12 +661,14 @@ function profileSetupTapReceipts(results) {
   }));
 }
 function profileSetupPressReceipts(results) {
-  return results.filter((result) => profileSetupResultAction(result) === "press").map((result) => ({
+  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,
     frame_selector: result.frame_selector ?? null,
     key: result.key ?? null,
+    hold_ms: result.hold_ms ?? null,
     reason: result.reason ?? result.error ?? null
   }));
 }
@@ -959,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;
   }
@@ -1130,6 +1134,11 @@ function normalizeSetupAction(input, index) {
   const toY = numberValue(valueFromOwn(input, "to_y", "toY", "end_y", "endY", "y2"));
   const coordinateMode = normalizeSetupActionCoordinateMode(valueFromOwn(input, "coordinate_mode", "coordinateMode", "coords", "units"), index);
   const pointerType = normalizeSetupActionPointerType(valueFromOwn(input, "pointer_type", "pointerType", "input_type", "inputType"), type, index);
+  const durationMs = numberValue(input.duration_ms) ?? numberValue(input.durationMs);
+  const holdMs = type === "press" ? normalizeSetupActionNonNegativeNumber(input, index, "hold_ms", "hold_ms", "holdMs", "key_down_ms", "keyDownMs", "down_ms", "downMs") ?? durationMs : void 0;
+  if (type === "press" && holdMs !== void 0 && (holdMs < 0 || holdMs > 3e4)) {
+    throw new Error(`target.setup_actions[${index}].hold_ms must be a finite number from 0 to 30000.`);
+  }
   if (type === "click") {
     const hasClickCoordinate = fromX !== void 0 || fromY !== void 0;
     if (hasClickCoordinate && (fromX === void 0 || fromY === void 0)) {
@@ -1210,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) {
@@ -1296,9 +1305,10 @@ function normalizeSetupAction(input, index) {
     from_y: fromY,
     to_x: toX,
     to_y: toY,
-    duration_ms: numberValue(input.duration_ms) ?? numberValue(input.durationMs),
+    duration_ms: durationMs,
     steps,
     key,
+    hold_ms: holdMs,
     value,
     value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
     random_queue: randomQueue,
@@ -4536,13 +4546,15 @@ function profileSetupTapReceipts(results) {
 }
 function profileSetupPressReceipts(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,
       frame_selector: result.frame_selector ?? null,
       key: result.key ?? null,
+      hold_ms: result.hold_ms ?? null,
       reason: result.reason || result.error || null,
     }));
 }
@@ -6476,12 +6488,56 @@ 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" };
+      const holdMs = Math.min(30000, Math.max(0, Math.floor(setupNumber(action.hold_ms ?? action.holdMs ?? action.key_down_ms ?? action.keyDownMs ?? action.down_ms ?? action.downMs ?? action.duration_ms ?? action.durationMs, 0) || 0)));
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
       if (!action.selector) {
+        if (holdMs > 0) {
+          if (scope.frame_selector) {
+            await scope.context.locator("body").focus({ timeout }).catch(() => {});
+          }
+          await page.keyboard.down(key);
+          try {
+            await page.waitForTimeout(holdMs);
+          } finally {
+            await page.keyboard.up(key).catch(() => {});
+          }
+          return { ...base, ...setupScopeEvidence(scope), ok: true, key, hold_ms: holdMs };
+        }
         if (scope.frame_selector) {
           await scope.context.locator("body").press(key, { timeout });
         } else {
@@ -6494,6 +6550,16 @@ async function executeSetupAction(action, ordinal, viewport) {
       if (!count) return { ...base, reason: "selector_not_found", count, key };
       const targetIndex = Number.isInteger(action.index) ? action.index : 0;
       if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex, key };
+      if (holdMs > 0) {
+        await locator.nth(targetIndex).focus({ timeout });
+        await page.keyboard.down(key);
+        try {
+          await page.waitForTimeout(holdMs);
+        } finally {
+          await page.keyboard.up(key).catch(() => {});
+        }
+        return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, key, hold_ms: holdMs };
+      }
       await locator.nth(targetIndex).press(key, { timeout });
       return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, key };
     }

package/dist/profile.d.cts

@@ -5,7 +5,7 @@ declare const RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION: "riddle-proof.profile-evide
 declare const RIDDLE_PROOF_PROFILE_RESULT_VERSION: "riddle-proof.profile-result.v1";
 declare const RIDDLE_PROOF_PROFILE_STATUSES: readonly ["passed", "product_regression", "proof_insufficient", "environment_blocked", "configuration_error", "needs_human_review"];
 declare const RIDDLE_PROOF_PROFILE_CHECK_TYPES: readonly ["route_loaded", "url_search_param_equals", "url_search_param_absent", "selector_visible", "selector_absent", "selector_count_at_least", "selector_count_equals", "selector_count_equal", "selector_count_eq", "dialog_count_equals", "dialog_accept_count_equals", "dialog_dismiss_count_equals", "selector_text_visible", "selector_text_absent", "selector_text_order", "observe_within", "frame_text_visible", "frame_url_equals", "frame_url_matches", "frame_no_horizontal_overflow", "text_visible", "text_absent", "http_status", "link_status", "artifact_link_status", "route_inventory", "no_horizontal_overflow", "no_mobile_horizontal_overflow", "no_fatal_console_errors", "no_console_warnings"];
-declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "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];
@@ -124,6 +124,7 @@ interface RiddleProofProfileSetupAction {
     duration_ms?: number;
     steps?: number;
     key?: string;
+    hold_ms?: number;
     value?: string;
     value_json?: JsonValue;
     random_queue?: number[];

package/dist/profile.d.ts

@@ -5,7 +5,7 @@ declare const RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION: "riddle-proof.profile-evide
 declare const RIDDLE_PROOF_PROFILE_RESULT_VERSION: "riddle-proof.profile-result.v1";
 declare const RIDDLE_PROOF_PROFILE_STATUSES: readonly ["passed", "product_regression", "proof_insufficient", "environment_blocked", "configuration_error", "needs_human_review"];
 declare const RIDDLE_PROOF_PROFILE_CHECK_TYPES: readonly ["route_loaded", "url_search_param_equals", "url_search_param_absent", "selector_visible", "selector_absent", "selector_count_at_least", "selector_count_equals", "selector_count_equal", "selector_count_eq", "dialog_count_equals", "dialog_accept_count_equals", "dialog_dismiss_count_equals", "selector_text_visible", "selector_text_absent", "selector_text_order", "observe_within", "frame_text_visible", "frame_url_equals", "frame_url_matches", "frame_no_horizontal_overflow", "text_visible", "text_absent", "http_status", "link_status", "artifact_link_status", "route_inventory", "no_horizontal_overflow", "no_mobile_horizontal_overflow", "no_fatal_console_errors", "no_console_warnings"];
-declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "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];
@@ -124,6 +124,7 @@ interface RiddleProofProfileSetupAction {
     duration_ms?: number;
     steps?: number;
     key?: string;
+    hold_ms?: number;
     value?: string;
     value_json?: JsonValue;
     random_queue?: number[];

package/dist/profile.js

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

package/package.json

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