@riddledc/riddle-proof 0.7.60 → 0.7.61

package/README.md

@@ -240,7 +240,7 @@ where the second request must carry newer state.
 `target.setup_actions` is optional. Use it when the meaningful proof surface
 appears only after a picker, tab, login stub, storage seed, form fill,
 transport control, or other bounded interaction. Supported setup actions are
-`click`, `press`, `fill`, `set_input_value`, `assert_text_visible`,
+`click`, `drag`, `press`, `fill`, `set_input_value`, `assert_text_visible`,
 `assert_text_absent`, `assert_selector_count`, `assert_window_value`,
 `assert_window_number`, `local_storage`, `session_storage`, `clear_storage`, `wait`,
 `wait_for_selector`, `wait_for_text`, and `window_call`; a failed setup action
@@ -253,6 +253,12 @@ stable enough for Playwright's default click actionability checks. Use `press`
 with a Playwright key name, such as `Enter`, `Space`, or `ArrowLeft`,
 when a route's intended browser control is keyboard-driven; omit `selector` for
 a page-level key press, or provide `selector` to press against a focused element.
+Use `drag` for pointer-driven controls such as canvas launch areas, sliders, or
+drag-to-aim games. Provide `selector`, `from_x`, `from_y`, `to_x`, and `to_y`;
+coordinates are element-relative pixels by default. Set `coordinate_mode:
+"ratio"` to make coordinates relative to the target element size, for example
+`from_x: 0.5, from_y: 0.5, to_x: 0.2, to_y: 0.5`. Optional `steps` and
+`duration_ms` control how gradually the pointer moves before release.
 Use setup assertions when the pre-click or pre-navigation state is part of the contract,
 for example a fresh row must be present, stale copy must be absent, exactly one
 source link must exist before clicking into the final route, or a canvas app's

package/dist/{chunk-FLQ4HHTT.js → chunk-T66DWLBE.js}

@@ -34,6 +34,7 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
 ];
 var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "click",
+  "drag",
   "press",
   "fill",
   "set_input_value",
@@ -204,7 +205,7 @@ function isSupportedCheckType(value) {
 }
 function normalizeSetupActionType(value, index) {
   const normalizedInput = String(value || "").trim().replace(/-/g, "_");
-  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput;
+  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput;
   if (RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.includes(normalized)) {
     return normalized;
   }
@@ -234,6 +235,13 @@ function normalizeSetupActionRepeat(input, index) {
   }
   return repeat;
 }
+function normalizeSetupActionCoordinateMode(value, index) {
+  if (value === void 0 || value === null || value === "") return void 0;
+  const normalized = String(value).trim().replace(/-/g, "_").toLowerCase();
+  if (normalized === "pixels" || normalized === "pixel" || normalized === "px") return "pixels";
+  if (normalized === "ratio" || normalized === "relative" || normalized === "fraction") return "ratio";
+  throw new Error(`target.setup_actions[${index}].coordinate_mode ${String(value)} is not supported. Supported coordinate modes: pixels, ratio.`);
+}
 function normalizeSetupAction(input, index) {
   if (!isRecord(input)) throw new Error(`target.setup_actions[${index}] must be an object.`);
   const type = normalizeSetupActionType(stringValue(input.type), index);
@@ -243,9 +251,25 @@ function normalizeSetupAction(input, index) {
   if (frameIndex !== void 0 && (!Number.isInteger(frameIndex) || frameIndex < 0)) {
     throw new Error(`target.setup_actions[${index}].frame_index must be a non-negative integer.`);
   }
-  if ((type === "click" || type === "fill" || type === "set_input_value" || type === "wait_for_selector" || type === "wait_for_text" || type === "assert_text_visible" || type === "assert_text_absent" || type === "assert_selector_count") && !selector) {
+  if ((type === "click" || type === "drag" || type === "fill" || type === "set_input_value" || type === "wait_for_selector" || type === "wait_for_text" || type === "assert_text_visible" || type === "assert_text_absent" || type === "assert_selector_count") && !selector) {
     throw new Error(`target.setup_actions[${index}] ${type} requires selector.`);
   }
+  const fromX = numberValue(valueFromOwn(input, "from_x", "fromX", "start_x", "startX", "x1"));
+  const fromY = numberValue(valueFromOwn(input, "from_y", "fromY", "start_y", "startY", "y1"));
+  const toX = numberValue(valueFromOwn(input, "to_x", "toX", "end_x", "endX", "x2"));
+  const toY = numberValue(valueFromOwn(input, "to_y", "toY", "end_y", "endY", "y2"));
+  const coordinateMode = normalizeSetupActionCoordinateMode(valueFromOwn(input, "coordinate_mode", "coordinateMode", "coords", "units"), index);
+  if (type === "drag") {
+    if (fromX === void 0 || fromY === void 0 || toX === void 0 || toY === void 0) {
+      throw new Error(`target.setup_actions[${index}] drag requires from_x, from_y, to_x, and to_y.`);
+    }
+    if (coordinateMode === "ratio" && [fromX, fromY, toX, toY].some((value2) => value2 < 0 || value2 > 1)) {
+      throw new Error(`target.setup_actions[${index}] drag ratio coordinates must be between 0 and 1.`);
+    }
+    if ((coordinateMode === void 0 || coordinateMode === "pixels") && [fromX, fromY, toX, toY].some((value2) => value2 < 0)) {
+      throw new Error(`target.setup_actions[${index}] drag pixel coordinates must be non-negative.`);
+    }
+  }
   if (type === "wait_for_text" && !stringValue(input.text) && !stringValue(input.pattern)) {
     throw new Error(`target.setup_actions[${index}] wait_for_text requires text or pattern.`);
   }
@@ -292,12 +316,23 @@ function normalizeSetupAction(input, index) {
     }
   }
   const hasExpectedReturn = hasOwn(input, "expect_return") || hasOwn(input, "expectReturn") || hasOwn(input, "expected_return") || hasOwn(input, "expectedReturn");
+  const steps = numberValue(input.steps);
+  if (type === "drag" && steps !== void 0 && (!Number.isInteger(steps) || steps < 1 || steps > 100)) {
+    throw new Error(`target.setup_actions[${index}].steps must be an integer from 1 to 100.`);
+  }
   return {
     type,
     selector,
     frame_selector: frameSelector,
     frame_index: frameIndex,
     force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
+    coordinate_mode: coordinateMode,
+    from_x: fromX,
+    from_y: fromY,
+    to_x: toX,
+    to_y: toY,
+    duration_ms: numberValue(input.duration_ms) ?? numberValue(input.durationMs),
+    steps,
     key,
     value,
     value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
@@ -2505,6 +2540,71 @@ async function executeSetupAction(action, ordinal) {
       await scope.context.waitForSelector(action.selector, { state: "visible", timeout });
       return { ...base, ...setupScopeEvidence(scope), ok: true, timeout_ms: timeout };
     }
+    if (type === "drag") {
+      const scope = await setupActionScope(action, timeout);
+      if (!scope.ok) return setupScopeFailure(base, scope);
+      const locator = scope.context.locator(action.selector);
+      const count = await locator.count();
+      if (!count) return { ...base, ...setupScopeEvidence(scope), reason: "selector_not_found", count };
+      const targetIndex = Number.isInteger(action.index) ? action.index : 0;
+      if (targetIndex < 0 || targetIndex >= count) return { ...base, ...setupScopeEvidence(scope), reason: "index_out_of_range", count, target_index: targetIndex };
+      const target = locator.nth(targetIndex);
+      await target.waitFor({ state: "visible", timeout });
+      const box = await target.boundingBox();
+      if (!box) return { ...base, ...setupScopeEvidence(scope), reason: "bounding_box_unavailable", count, target_index: targetIndex };
+      const mode = String(action.coordinate_mode || action.coordinateMode || "pixels").trim();
+      const coordinate = (value, size) => mode === "ratio" ? value * size : value;
+      const fromX = setupFiniteNumber(action.from_x ?? action.fromX ?? action.start_x ?? action.startX ?? action.x1);
+      const fromY = setupFiniteNumber(action.from_y ?? action.fromY ?? action.start_y ?? action.startY ?? action.y1);
+      const toX = setupFiniteNumber(action.to_x ?? action.toX ?? action.end_x ?? action.endX ?? action.x2);
+      const toY = setupFiniteNumber(action.to_y ?? action.toY ?? action.end_y ?? action.endY ?? action.y2);
+      if (fromX === undefined || fromY === undefined || toX === undefined || toY === undefined) return { ...base, ...setupScopeEvidence(scope), reason: "missing_drag_coordinates", count, target_index: targetIndex };
+      if (mode === "ratio" && [fromX, fromY, toX, toY].some((value) => value < 0 || value > 1)) return { ...base, ...setupScopeEvidence(scope), reason: "invalid_ratio_coordinates", count, target_index: targetIndex };
+      if (mode !== "ratio" && [fromX, fromY, toX, toY].some((value) => value < 0)) return { ...base, ...setupScopeEvidence(scope), reason: "invalid_pixel_coordinates", count, target_index: targetIndex };
+      const start = {
+        x: box.x + coordinate(fromX, box.width),
+        y: box.y + coordinate(fromY, box.height),
+      };
+      const end = {
+        x: box.x + coordinate(toX, box.width),
+        y: box.y + coordinate(toY, box.height),
+      };
+      const requestedSteps = setupNumber(action.steps, 8);
+      const steps = Math.min(100, Math.max(1, Math.floor(requestedSteps || 8)));
+      const durationMs = setupNumber(action.duration_ms ?? action.durationMs, 0);
+      await page.mouse.move(start.x, start.y);
+      await page.mouse.down();
+      try {
+        if (durationMs && steps > 1) {
+          for (let step = 1; step <= steps; step += 1) {
+            const progress = step / steps;
+            await page.mouse.move(
+              start.x + (end.x - start.x) * progress,
+              start.y + (end.y - start.y) * progress,
+            );
+            await page.waitForTimeout(durationMs / steps);
+          }
+        } else {
+          await page.mouse.move(end.x, end.y, { steps });
+        }
+      } finally {
+        await page.mouse.up().catch(() => {});
+      }
+      return {
+        ...base,
+        ...setupScopeEvidence(scope),
+        ok: true,
+        count,
+        target_index: targetIndex,
+        coordinate_mode: mode,
+        from_x: fromX,
+        from_y: fromY,
+        to_x: toX,
+        to_y: toY,
+        steps,
+        duration_ms: durationMs || undefined,
+      };
+    }
     if (type === "press") {
       const key = String(action.key || "").trim();
       if (!key) return { ...base, reason: "missing_key" };

package/dist/cli.cjs

@@ -6907,6 +6907,7 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
 ];
 var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "click",
+  "drag",
   "press",
   "fill",
   "set_input_value",
@@ -7077,7 +7078,7 @@ function isSupportedCheckType(value) {
 }
 function normalizeSetupActionType(value, index) {
   const normalizedInput = String(value || "").trim().replace(/-/g, "_");
-  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput;
+  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput;
   if (RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.includes(normalized)) {
     return normalized;
   }
@@ -7107,6 +7108,13 @@ function normalizeSetupActionRepeat(input, index) {
   }
   return repeat;
 }
+function normalizeSetupActionCoordinateMode(value, index) {
+  if (value === void 0 || value === null || value === "") return void 0;
+  const normalized = String(value).trim().replace(/-/g, "_").toLowerCase();
+  if (normalized === "pixels" || normalized === "pixel" || normalized === "px") return "pixels";
+  if (normalized === "ratio" || normalized === "relative" || normalized === "fraction") return "ratio";
+  throw new Error(`target.setup_actions[${index}].coordinate_mode ${String(value)} is not supported. Supported coordinate modes: pixels, ratio.`);
+}
 function normalizeSetupAction(input, index) {
   if (!isRecord(input)) throw new Error(`target.setup_actions[${index}] must be an object.`);
   const type = normalizeSetupActionType(stringValue2(input.type), index);
@@ -7116,9 +7124,25 @@ function normalizeSetupAction(input, index) {
   if (frameIndex !== void 0 && (!Number.isInteger(frameIndex) || frameIndex < 0)) {
     throw new Error(`target.setup_actions[${index}].frame_index must be a non-negative integer.`);
   }
-  if ((type === "click" || type === "fill" || type === "set_input_value" || type === "wait_for_selector" || type === "wait_for_text" || type === "assert_text_visible" || type === "assert_text_absent" || type === "assert_selector_count") && !selector) {
+  if ((type === "click" || type === "drag" || type === "fill" || type === "set_input_value" || type === "wait_for_selector" || type === "wait_for_text" || type === "assert_text_visible" || type === "assert_text_absent" || type === "assert_selector_count") && !selector) {
     throw new Error(`target.setup_actions[${index}] ${type} requires selector.`);
   }
+  const fromX = numberValue(valueFromOwn(input, "from_x", "fromX", "start_x", "startX", "x1"));
+  const fromY = numberValue(valueFromOwn(input, "from_y", "fromY", "start_y", "startY", "y1"));
+  const toX = numberValue(valueFromOwn(input, "to_x", "toX", "end_x", "endX", "x2"));
+  const toY = numberValue(valueFromOwn(input, "to_y", "toY", "end_y", "endY", "y2"));
+  const coordinateMode = normalizeSetupActionCoordinateMode(valueFromOwn(input, "coordinate_mode", "coordinateMode", "coords", "units"), index);
+  if (type === "drag") {
+    if (fromX === void 0 || fromY === void 0 || toX === void 0 || toY === void 0) {
+      throw new Error(`target.setup_actions[${index}] drag requires from_x, from_y, to_x, and to_y.`);
+    }
+    if (coordinateMode === "ratio" && [fromX, fromY, toX, toY].some((value2) => value2 < 0 || value2 > 1)) {
+      throw new Error(`target.setup_actions[${index}] drag ratio coordinates must be between 0 and 1.`);
+    }
+    if ((coordinateMode === void 0 || coordinateMode === "pixels") && [fromX, fromY, toX, toY].some((value2) => value2 < 0)) {
+      throw new Error(`target.setup_actions[${index}] drag pixel coordinates must be non-negative.`);
+    }
+  }
   if (type === "wait_for_text" && !stringValue2(input.text) && !stringValue2(input.pattern)) {
     throw new Error(`target.setup_actions[${index}] wait_for_text requires text or pattern.`);
   }
@@ -7165,12 +7189,23 @@ function normalizeSetupAction(input, index) {
     }
   }
   const hasExpectedReturn = hasOwn(input, "expect_return") || hasOwn(input, "expectReturn") || hasOwn(input, "expected_return") || hasOwn(input, "expectedReturn");
+  const steps = numberValue(input.steps);
+  if (type === "drag" && steps !== void 0 && (!Number.isInteger(steps) || steps < 1 || steps > 100)) {
+    throw new Error(`target.setup_actions[${index}].steps must be an integer from 1 to 100.`);
+  }
   return {
     type,
     selector,
     frame_selector: frameSelector,
     frame_index: frameIndex,
     force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
+    coordinate_mode: coordinateMode,
+    from_x: fromX,
+    from_y: fromY,
+    to_x: toX,
+    to_y: toY,
+    duration_ms: numberValue(input.duration_ms) ?? numberValue(input.durationMs),
+    steps,
     key,
     value,
     value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
@@ -9362,6 +9397,71 @@ async function executeSetupAction(action, ordinal) {
       await scope.context.waitForSelector(action.selector, { state: "visible", timeout });
       return { ...base, ...setupScopeEvidence(scope), ok: true, timeout_ms: timeout };
     }
+    if (type === "drag") {
+      const scope = await setupActionScope(action, timeout);
+      if (!scope.ok) return setupScopeFailure(base, scope);
+      const locator = scope.context.locator(action.selector);
+      const count = await locator.count();
+      if (!count) return { ...base, ...setupScopeEvidence(scope), reason: "selector_not_found", count };
+      const targetIndex = Number.isInteger(action.index) ? action.index : 0;
+      if (targetIndex < 0 || targetIndex >= count) return { ...base, ...setupScopeEvidence(scope), reason: "index_out_of_range", count, target_index: targetIndex };
+      const target = locator.nth(targetIndex);
+      await target.waitFor({ state: "visible", timeout });
+      const box = await target.boundingBox();
+      if (!box) return { ...base, ...setupScopeEvidence(scope), reason: "bounding_box_unavailable", count, target_index: targetIndex };
+      const mode = String(action.coordinate_mode || action.coordinateMode || "pixels").trim();
+      const coordinate = (value, size) => mode === "ratio" ? value * size : value;
+      const fromX = setupFiniteNumber(action.from_x ?? action.fromX ?? action.start_x ?? action.startX ?? action.x1);
+      const fromY = setupFiniteNumber(action.from_y ?? action.fromY ?? action.start_y ?? action.startY ?? action.y1);
+      const toX = setupFiniteNumber(action.to_x ?? action.toX ?? action.end_x ?? action.endX ?? action.x2);
+      const toY = setupFiniteNumber(action.to_y ?? action.toY ?? action.end_y ?? action.endY ?? action.y2);
+      if (fromX === undefined || fromY === undefined || toX === undefined || toY === undefined) return { ...base, ...setupScopeEvidence(scope), reason: "missing_drag_coordinates", count, target_index: targetIndex };
+      if (mode === "ratio" && [fromX, fromY, toX, toY].some((value) => value < 0 || value > 1)) return { ...base, ...setupScopeEvidence(scope), reason: "invalid_ratio_coordinates", count, target_index: targetIndex };
+      if (mode !== "ratio" && [fromX, fromY, toX, toY].some((value) => value < 0)) return { ...base, ...setupScopeEvidence(scope), reason: "invalid_pixel_coordinates", count, target_index: targetIndex };
+      const start = {
+        x: box.x + coordinate(fromX, box.width),
+        y: box.y + coordinate(fromY, box.height),
+      };
+      const end = {
+        x: box.x + coordinate(toX, box.width),
+        y: box.y + coordinate(toY, box.height),
+      };
+      const requestedSteps = setupNumber(action.steps, 8);
+      const steps = Math.min(100, Math.max(1, Math.floor(requestedSteps || 8)));
+      const durationMs = setupNumber(action.duration_ms ?? action.durationMs, 0);
+      await page.mouse.move(start.x, start.y);
+      await page.mouse.down();
+      try {
+        if (durationMs && steps > 1) {
+          for (let step = 1; step <= steps; step += 1) {
+            const progress = step / steps;
+            await page.mouse.move(
+              start.x + (end.x - start.x) * progress,
+              start.y + (end.y - start.y) * progress,
+            );
+            await page.waitForTimeout(durationMs / steps);
+          }
+        } else {
+          await page.mouse.move(end.x, end.y, { steps });
+        }
+      } finally {
+        await page.mouse.up().catch(() => {});
+      }
+      return {
+        ...base,
+        ...setupScopeEvidence(scope),
+        ok: true,
+        count,
+        target_index: targetIndex,
+        coordinate_mode: mode,
+        from_x: fromX,
+        from_y: fromY,
+        to_x: toX,
+        to_y: toY,
+        steps,
+        duration_ms: durationMs || undefined,
+      };
+    }
     if (type === "press") {
       const key = String(action.key || "").trim();
       if (!key) return { ...base, reason: "missing_key" };

package/dist/cli.js

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

package/dist/index.cjs

@@ -8748,6 +8748,7 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
 ];
 var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "click",
+  "drag",
   "press",
   "fill",
   "set_input_value",
@@ -8918,7 +8919,7 @@ function isSupportedCheckType(value) {
 }
 function normalizeSetupActionType(value, index) {
   const normalizedInput = String(value || "").trim().replace(/-/g, "_");
-  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput;
+  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput;
   if (RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.includes(normalized)) {
     return normalized;
   }
@@ -8948,6 +8949,13 @@ function normalizeSetupActionRepeat(input, index) {
   }
   return repeat;
 }
+function normalizeSetupActionCoordinateMode(value, index) {
+  if (value === void 0 || value === null || value === "") return void 0;
+  const normalized = String(value).trim().replace(/-/g, "_").toLowerCase();
+  if (normalized === "pixels" || normalized === "pixel" || normalized === "px") return "pixels";
+  if (normalized === "ratio" || normalized === "relative" || normalized === "fraction") return "ratio";
+  throw new Error(`target.setup_actions[${index}].coordinate_mode ${String(value)} is not supported. Supported coordinate modes: pixels, ratio.`);
+}
 function normalizeSetupAction(input, index) {
   if (!isRecord2(input)) throw new Error(`target.setup_actions[${index}] must be an object.`);
   const type = normalizeSetupActionType(stringValue5(input.type), index);
@@ -8957,9 +8965,25 @@ function normalizeSetupAction(input, index) {
   if (frameIndex !== void 0 && (!Number.isInteger(frameIndex) || frameIndex < 0)) {
     throw new Error(`target.setup_actions[${index}].frame_index must be a non-negative integer.`);
   }
-  if ((type === "click" || type === "fill" || type === "set_input_value" || type === "wait_for_selector" || type === "wait_for_text" || type === "assert_text_visible" || type === "assert_text_absent" || type === "assert_selector_count") && !selector) {
+  if ((type === "click" || type === "drag" || type === "fill" || type === "set_input_value" || type === "wait_for_selector" || type === "wait_for_text" || type === "assert_text_visible" || type === "assert_text_absent" || type === "assert_selector_count") && !selector) {
     throw new Error(`target.setup_actions[${index}] ${type} requires selector.`);
   }
+  const fromX = numberValue3(valueFromOwn(input, "from_x", "fromX", "start_x", "startX", "x1"));
+  const fromY = numberValue3(valueFromOwn(input, "from_y", "fromY", "start_y", "startY", "y1"));
+  const toX = numberValue3(valueFromOwn(input, "to_x", "toX", "end_x", "endX", "x2"));
+  const toY = numberValue3(valueFromOwn(input, "to_y", "toY", "end_y", "endY", "y2"));
+  const coordinateMode = normalizeSetupActionCoordinateMode(valueFromOwn(input, "coordinate_mode", "coordinateMode", "coords", "units"), index);
+  if (type === "drag") {
+    if (fromX === void 0 || fromY === void 0 || toX === void 0 || toY === void 0) {
+      throw new Error(`target.setup_actions[${index}] drag requires from_x, from_y, to_x, and to_y.`);
+    }
+    if (coordinateMode === "ratio" && [fromX, fromY, toX, toY].some((value2) => value2 < 0 || value2 > 1)) {
+      throw new Error(`target.setup_actions[${index}] drag ratio coordinates must be between 0 and 1.`);
+    }
+    if ((coordinateMode === void 0 || coordinateMode === "pixels") && [fromX, fromY, toX, toY].some((value2) => value2 < 0)) {
+      throw new Error(`target.setup_actions[${index}] drag pixel coordinates must be non-negative.`);
+    }
+  }
   if (type === "wait_for_text" && !stringValue5(input.text) && !stringValue5(input.pattern)) {
     throw new Error(`target.setup_actions[${index}] wait_for_text requires text or pattern.`);
   }
@@ -9006,12 +9030,23 @@ function normalizeSetupAction(input, index) {
     }
   }
   const hasExpectedReturn = hasOwn(input, "expect_return") || hasOwn(input, "expectReturn") || hasOwn(input, "expected_return") || hasOwn(input, "expectedReturn");
+  const steps = numberValue3(input.steps);
+  if (type === "drag" && steps !== void 0 && (!Number.isInteger(steps) || steps < 1 || steps > 100)) {
+    throw new Error(`target.setup_actions[${index}].steps must be an integer from 1 to 100.`);
+  }
   return {
     type,
     selector,
     frame_selector: frameSelector,
     frame_index: frameIndex,
     force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
+    coordinate_mode: coordinateMode,
+    from_x: fromX,
+    from_y: fromY,
+    to_x: toX,
+    to_y: toY,
+    duration_ms: numberValue3(input.duration_ms) ?? numberValue3(input.durationMs),
+    steps,
     key,
     value,
     value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
@@ -11219,6 +11254,71 @@ async function executeSetupAction(action, ordinal) {
       await scope.context.waitForSelector(action.selector, { state: "visible", timeout });
       return { ...base, ...setupScopeEvidence(scope), ok: true, timeout_ms: timeout };
     }
+    if (type === "drag") {
+      const scope = await setupActionScope(action, timeout);
+      if (!scope.ok) return setupScopeFailure(base, scope);
+      const locator = scope.context.locator(action.selector);
+      const count = await locator.count();
+      if (!count) return { ...base, ...setupScopeEvidence(scope), reason: "selector_not_found", count };
+      const targetIndex = Number.isInteger(action.index) ? action.index : 0;
+      if (targetIndex < 0 || targetIndex >= count) return { ...base, ...setupScopeEvidence(scope), reason: "index_out_of_range", count, target_index: targetIndex };
+      const target = locator.nth(targetIndex);
+      await target.waitFor({ state: "visible", timeout });
+      const box = await target.boundingBox();
+      if (!box) return { ...base, ...setupScopeEvidence(scope), reason: "bounding_box_unavailable", count, target_index: targetIndex };
+      const mode = String(action.coordinate_mode || action.coordinateMode || "pixels").trim();
+      const coordinate = (value, size) => mode === "ratio" ? value * size : value;
+      const fromX = setupFiniteNumber(action.from_x ?? action.fromX ?? action.start_x ?? action.startX ?? action.x1);
+      const fromY = setupFiniteNumber(action.from_y ?? action.fromY ?? action.start_y ?? action.startY ?? action.y1);
+      const toX = setupFiniteNumber(action.to_x ?? action.toX ?? action.end_x ?? action.endX ?? action.x2);
+      const toY = setupFiniteNumber(action.to_y ?? action.toY ?? action.end_y ?? action.endY ?? action.y2);
+      if (fromX === undefined || fromY === undefined || toX === undefined || toY === undefined) return { ...base, ...setupScopeEvidence(scope), reason: "missing_drag_coordinates", count, target_index: targetIndex };
+      if (mode === "ratio" && [fromX, fromY, toX, toY].some((value) => value < 0 || value > 1)) return { ...base, ...setupScopeEvidence(scope), reason: "invalid_ratio_coordinates", count, target_index: targetIndex };
+      if (mode !== "ratio" && [fromX, fromY, toX, toY].some((value) => value < 0)) return { ...base, ...setupScopeEvidence(scope), reason: "invalid_pixel_coordinates", count, target_index: targetIndex };
+      const start = {
+        x: box.x + coordinate(fromX, box.width),
+        y: box.y + coordinate(fromY, box.height),
+      };
+      const end = {
+        x: box.x + coordinate(toX, box.width),
+        y: box.y + coordinate(toY, box.height),
+      };
+      const requestedSteps = setupNumber(action.steps, 8);
+      const steps = Math.min(100, Math.max(1, Math.floor(requestedSteps || 8)));
+      const durationMs = setupNumber(action.duration_ms ?? action.durationMs, 0);
+      await page.mouse.move(start.x, start.y);
+      await page.mouse.down();
+      try {
+        if (durationMs && steps > 1) {
+          for (let step = 1; step <= steps; step += 1) {
+            const progress = step / steps;
+            await page.mouse.move(
+              start.x + (end.x - start.x) * progress,
+              start.y + (end.y - start.y) * progress,
+            );
+            await page.waitForTimeout(durationMs / steps);
+          }
+        } else {
+          await page.mouse.move(end.x, end.y, { steps });
+        }
+      } finally {
+        await page.mouse.up().catch(() => {});
+      }
+      return {
+        ...base,
+        ...setupScopeEvidence(scope),
+        ok: true,
+        count,
+        target_index: targetIndex,
+        coordinate_mode: mode,
+        from_x: fromX,
+        from_y: fromY,
+        to_x: toX,
+        to_y: toY,
+        steps,
+        duration_ms: durationMs || undefined,
+      };
+    }
     if (type === "press") {
       const key = String(action.key || "").trim();
       if (!key) return { ...base, reason: "missing_key" };

package/dist/index.js

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

package/dist/profile.cjs

@@ -77,6 +77,7 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
 ];
 var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "click",
+  "drag",
   "press",
   "fill",
   "set_input_value",
@@ -247,7 +248,7 @@ function isSupportedCheckType(value) {
 }
 function normalizeSetupActionType(value, index) {
   const normalizedInput = String(value || "").trim().replace(/-/g, "_");
-  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput;
+  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput;
   if (RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.includes(normalized)) {
     return normalized;
   }
@@ -277,6 +278,13 @@ function normalizeSetupActionRepeat(input, index) {
   }
   return repeat;
 }
+function normalizeSetupActionCoordinateMode(value, index) {
+  if (value === void 0 || value === null || value === "") return void 0;
+  const normalized = String(value).trim().replace(/-/g, "_").toLowerCase();
+  if (normalized === "pixels" || normalized === "pixel" || normalized === "px") return "pixels";
+  if (normalized === "ratio" || normalized === "relative" || normalized === "fraction") return "ratio";
+  throw new Error(`target.setup_actions[${index}].coordinate_mode ${String(value)} is not supported. Supported coordinate modes: pixels, ratio.`);
+}
 function normalizeSetupAction(input, index) {
   if (!isRecord(input)) throw new Error(`target.setup_actions[${index}] must be an object.`);
   const type = normalizeSetupActionType(stringValue(input.type), index);
@@ -286,9 +294,25 @@ function normalizeSetupAction(input, index) {
   if (frameIndex !== void 0 && (!Number.isInteger(frameIndex) || frameIndex < 0)) {
     throw new Error(`target.setup_actions[${index}].frame_index must be a non-negative integer.`);
   }
-  if ((type === "click" || type === "fill" || type === "set_input_value" || type === "wait_for_selector" || type === "wait_for_text" || type === "assert_text_visible" || type === "assert_text_absent" || type === "assert_selector_count") && !selector) {
+  if ((type === "click" || type === "drag" || type === "fill" || type === "set_input_value" || type === "wait_for_selector" || type === "wait_for_text" || type === "assert_text_visible" || type === "assert_text_absent" || type === "assert_selector_count") && !selector) {
     throw new Error(`target.setup_actions[${index}] ${type} requires selector.`);
   }
+  const fromX = numberValue(valueFromOwn(input, "from_x", "fromX", "start_x", "startX", "x1"));
+  const fromY = numberValue(valueFromOwn(input, "from_y", "fromY", "start_y", "startY", "y1"));
+  const toX = numberValue(valueFromOwn(input, "to_x", "toX", "end_x", "endX", "x2"));
+  const toY = numberValue(valueFromOwn(input, "to_y", "toY", "end_y", "endY", "y2"));
+  const coordinateMode = normalizeSetupActionCoordinateMode(valueFromOwn(input, "coordinate_mode", "coordinateMode", "coords", "units"), index);
+  if (type === "drag") {
+    if (fromX === void 0 || fromY === void 0 || toX === void 0 || toY === void 0) {
+      throw new Error(`target.setup_actions[${index}] drag requires from_x, from_y, to_x, and to_y.`);
+    }
+    if (coordinateMode === "ratio" && [fromX, fromY, toX, toY].some((value2) => value2 < 0 || value2 > 1)) {
+      throw new Error(`target.setup_actions[${index}] drag ratio coordinates must be between 0 and 1.`);
+    }
+    if ((coordinateMode === void 0 || coordinateMode === "pixels") && [fromX, fromY, toX, toY].some((value2) => value2 < 0)) {
+      throw new Error(`target.setup_actions[${index}] drag pixel coordinates must be non-negative.`);
+    }
+  }
   if (type === "wait_for_text" && !stringValue(input.text) && !stringValue(input.pattern)) {
     throw new Error(`target.setup_actions[${index}] wait_for_text requires text or pattern.`);
   }
@@ -335,12 +359,23 @@ function normalizeSetupAction(input, index) {
     }
   }
   const hasExpectedReturn = hasOwn(input, "expect_return") || hasOwn(input, "expectReturn") || hasOwn(input, "expected_return") || hasOwn(input, "expectedReturn");
+  const steps = numberValue(input.steps);
+  if (type === "drag" && steps !== void 0 && (!Number.isInteger(steps) || steps < 1 || steps > 100)) {
+    throw new Error(`target.setup_actions[${index}].steps must be an integer from 1 to 100.`);
+  }
   return {
     type,
     selector,
     frame_selector: frameSelector,
     frame_index: frameIndex,
     force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
+    coordinate_mode: coordinateMode,
+    from_x: fromX,
+    from_y: fromY,
+    to_x: toX,
+    to_y: toY,
+    duration_ms: numberValue(input.duration_ms) ?? numberValue(input.durationMs),
+    steps,
     key,
     value,
     value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
@@ -2548,6 +2583,71 @@ async function executeSetupAction(action, ordinal) {
       await scope.context.waitForSelector(action.selector, { state: "visible", timeout });
       return { ...base, ...setupScopeEvidence(scope), ok: true, timeout_ms: timeout };
     }
+    if (type === "drag") {
+      const scope = await setupActionScope(action, timeout);
+      if (!scope.ok) return setupScopeFailure(base, scope);
+      const locator = scope.context.locator(action.selector);
+      const count = await locator.count();
+      if (!count) return { ...base, ...setupScopeEvidence(scope), reason: "selector_not_found", count };
+      const targetIndex = Number.isInteger(action.index) ? action.index : 0;
+      if (targetIndex < 0 || targetIndex >= count) return { ...base, ...setupScopeEvidence(scope), reason: "index_out_of_range", count, target_index: targetIndex };
+      const target = locator.nth(targetIndex);
+      await target.waitFor({ state: "visible", timeout });
+      const box = await target.boundingBox();
+      if (!box) return { ...base, ...setupScopeEvidence(scope), reason: "bounding_box_unavailable", count, target_index: targetIndex };
+      const mode = String(action.coordinate_mode || action.coordinateMode || "pixels").trim();
+      const coordinate = (value, size) => mode === "ratio" ? value * size : value;
+      const fromX = setupFiniteNumber(action.from_x ?? action.fromX ?? action.start_x ?? action.startX ?? action.x1);
+      const fromY = setupFiniteNumber(action.from_y ?? action.fromY ?? action.start_y ?? action.startY ?? action.y1);
+      const toX = setupFiniteNumber(action.to_x ?? action.toX ?? action.end_x ?? action.endX ?? action.x2);
+      const toY = setupFiniteNumber(action.to_y ?? action.toY ?? action.end_y ?? action.endY ?? action.y2);
+      if (fromX === undefined || fromY === undefined || toX === undefined || toY === undefined) return { ...base, ...setupScopeEvidence(scope), reason: "missing_drag_coordinates", count, target_index: targetIndex };
+      if (mode === "ratio" && [fromX, fromY, toX, toY].some((value) => value < 0 || value > 1)) return { ...base, ...setupScopeEvidence(scope), reason: "invalid_ratio_coordinates", count, target_index: targetIndex };
+      if (mode !== "ratio" && [fromX, fromY, toX, toY].some((value) => value < 0)) return { ...base, ...setupScopeEvidence(scope), reason: "invalid_pixel_coordinates", count, target_index: targetIndex };
+      const start = {
+        x: box.x + coordinate(fromX, box.width),
+        y: box.y + coordinate(fromY, box.height),
+      };
+      const end = {
+        x: box.x + coordinate(toX, box.width),
+        y: box.y + coordinate(toY, box.height),
+      };
+      const requestedSteps = setupNumber(action.steps, 8);
+      const steps = Math.min(100, Math.max(1, Math.floor(requestedSteps || 8)));
+      const durationMs = setupNumber(action.duration_ms ?? action.durationMs, 0);
+      await page.mouse.move(start.x, start.y);
+      await page.mouse.down();
+      try {
+        if (durationMs && steps > 1) {
+          for (let step = 1; step <= steps; step += 1) {
+            const progress = step / steps;
+            await page.mouse.move(
+              start.x + (end.x - start.x) * progress,
+              start.y + (end.y - start.y) * progress,
+            );
+            await page.waitForTimeout(durationMs / steps);
+          }
+        } else {
+          await page.mouse.move(end.x, end.y, { steps });
+        }
+      } finally {
+        await page.mouse.up().catch(() => {});
+      }
+      return {
+        ...base,
+        ...setupScopeEvidence(scope),
+        ok: true,
+        count,
+        target_index: targetIndex,
+        coordinate_mode: mode,
+        from_x: fromX,
+        from_y: fromY,
+        to_x: toX,
+        to_y: toY,
+        steps,
+        duration_ms: durationMs || undefined,
+      };
+    }
     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", "selector_text_order", "frame_text_visible", "frame_url_equals", "frame_url_matches", "frame_no_horizontal_overflow", "text_visible", "text_absent", "route_inventory", "no_horizontal_overflow", "no_mobile_horizontal_overflow", "no_fatal_console_errors"];
-declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "press", "fill", "set_input_value", "assert_text_visible", "assert_text_absent", "assert_selector_count", "assert_window_value", "assert_window_number", "local_storage", "session_storage", "clear_storage", "wait", "wait_for_selector", "wait_for_text", "window_call"];
+declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "drag", "press", "fill", "set_input_value", "assert_text_visible", "assert_text_absent", "assert_selector_count", "assert_window_value", "assert_window_number", "local_storage", "session_storage", "clear_storage", "wait", "wait_for_selector", "wait_for_text", "window_call"];
 type RiddleProofProfileStatus = typeof RIDDLE_PROOF_PROFILE_STATUSES[number];
 type RiddleProofProfileCheckType = typeof RIDDLE_PROOF_PROFILE_CHECK_TYPES[number];
 type RiddleProofProfileSetupActionType = typeof RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES[number];
@@ -23,6 +23,13 @@ interface RiddleProofProfileSetupAction {
     frame_selector?: string;
     frame_index?: number;
     force?: boolean;
+    coordinate_mode?: "pixels" | "ratio";
+    from_x?: number;
+    from_y?: number;
+    to_x?: number;
+    to_y?: number;
+    duration_ms?: number;
+    steps?: number;
     key?: string;
     value?: string;
     value_json?: JsonValue;

package/dist/profile.d.ts

@@ -5,7 +5,7 @@ declare const RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION: "riddle-proof.profile-evide
 declare const RIDDLE_PROOF_PROFILE_RESULT_VERSION: "riddle-proof.profile-result.v1";
 declare const RIDDLE_PROOF_PROFILE_STATUSES: readonly ["passed", "product_regression", "proof_insufficient", "environment_blocked", "configuration_error", "needs_human_review"];
 declare const RIDDLE_PROOF_PROFILE_CHECK_TYPES: readonly ["route_loaded", "url_search_param_equals", "url_search_param_absent", "selector_visible", "selector_absent", "selector_count_at_least", "selector_count_equals", "selector_count_equal", "selector_count_eq", "selector_text_order", "frame_text_visible", "frame_url_equals", "frame_url_matches", "frame_no_horizontal_overflow", "text_visible", "text_absent", "route_inventory", "no_horizontal_overflow", "no_mobile_horizontal_overflow", "no_fatal_console_errors"];
-declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "press", "fill", "set_input_value", "assert_text_visible", "assert_text_absent", "assert_selector_count", "assert_window_value", "assert_window_number", "local_storage", "session_storage", "clear_storage", "wait", "wait_for_selector", "wait_for_text", "window_call"];
+declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "drag", "press", "fill", "set_input_value", "assert_text_visible", "assert_text_absent", "assert_selector_count", "assert_window_value", "assert_window_number", "local_storage", "session_storage", "clear_storage", "wait", "wait_for_selector", "wait_for_text", "window_call"];
 type RiddleProofProfileStatus = typeof RIDDLE_PROOF_PROFILE_STATUSES[number];
 type RiddleProofProfileCheckType = typeof RIDDLE_PROOF_PROFILE_CHECK_TYPES[number];
 type RiddleProofProfileSetupActionType = typeof RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES[number];
@@ -23,6 +23,13 @@ interface RiddleProofProfileSetupAction {
     frame_selector?: string;
     frame_index?: number;
     force?: boolean;
+    coordinate_mode?: "pixels" | "ratio";
+    from_x?: number;
+    from_y?: number;
+    to_x?: number;
+    to_y?: number;
+    duration_ms?: number;
+    steps?: number;
     key?: string;
     value?: string;
     value_json?: JsonValue;

package/dist/profile.js

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