@riddledc/riddle-proof 0.7.181 → 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`,
@@ -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-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,7 +614,8 @@ 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,
@@ -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) {
@@ -4496,8 +4499,9 @@ 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,
@@ -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

@@ -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,7 +7571,8 @@ 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,
@@ -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) {
@@ -11437,8 +11440,9 @@ 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,
@@ -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);
@@ -16596,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";
@@ -16707,13 +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)}` : ""}${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.`);
   const canvasSignatureGroups = viewports.map((viewport) => {
@@ -16876,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-T664I6R3.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,13 +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)}` : ""}${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.`);
   const canvasSignatureGroups = viewports.map((viewport) => {
@@ -1128,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,7 +9347,8 @@ 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,
@@ -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) {
@@ -13229,8 +13232,9 @@ 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,
@@ -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

@@ -62,7 +62,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-T664I6R3.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,7 +661,8 @@ 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,
@@ -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) {
@@ -4543,8 +4546,9 @@ 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,
@@ -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

@@ -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

@@ -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

@@ -23,7 +23,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-T664I6R3.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.181",
+  "version": "0.7.182",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",