@riddledc/riddle-proof 0.7.164 → 0.7.166

package/dist/{chunk-RXJ7YQBJ.js → chunk-L6WJP5IY.js}

@@ -551,6 +551,24 @@ function profileSetupRangeValueReceipts(results) {
     reason: result.reason ?? result.error ?? null
   }));
 }
+function profileSetupDragReceipts(results) {
+  return results.filter((result) => profileSetupResultAction(result) === "drag").map((result) => ({
+    ordinal: result.ordinal ?? null,
+    ok: result.ok !== false,
+    selector: result.selector ?? null,
+    frame_selector: result.frame_selector ?? null,
+    pointer_type: result.pointer_type ?? null,
+    input_dispatch: result.input_dispatch ?? null,
+    coordinate_mode: result.coordinate_mode ?? null,
+    from_x: result.from_x ?? null,
+    from_y: result.from_y ?? null,
+    to_x: result.to_x ?? null,
+    to_y: result.to_y ?? null,
+    steps: result.steps ?? null,
+    duration_ms: result.duration_ms ?? null,
+    reason: result.reason ?? result.error ?? null
+  }));
+}
 function profileSetupCanvasSignatureReceipts(results) {
   return results.filter((result) => profileSetupResultAction(result) === "canvas_signature").map((result) => ({
     ordinal: result.ordinal ?? null,
@@ -650,6 +668,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
       const sampledWindowEvalReceipts = sampleProfileSetupSummaryItems(windowEvalReceipts, 8);
       const rangeValueReceipts = profileSetupRangeValueReceipts(results);
       const sampledRangeValueReceipts = sampleProfileSetupSummaryItems(rangeValueReceipts, 8);
+      const dragReceipts = profileSetupDragReceipts(results);
+      const sampledDragReceipts = sampleProfileSetupSummaryItems(dragReceipts, 8);
       const canvasSignatureReceipts = profileSetupCanvasSignatureReceipts(results);
       const sampledCanvasSignatureReceipts = sampleProfileSetupSummaryItems(canvasSignatureReceipts, 8);
       const clickedItems = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => {
@@ -703,6 +723,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
         set_range_value_total: rangeValueReceipts.length,
         set_range_value_truncated: rangeValueReceipts.length > sampledRangeValueReceipts.length,
         set_range_value: sampledRangeValueReceipts,
+        drag_total: dragReceipts.length,
+        drag_truncated: dragReceipts.length > sampledDragReceipts.length,
+        drag: sampledDragReceipts,
         canvas_signature_total: canvasSignatureReceipts.length,
         canvas_signature_truncated: canvasSignatureReceipts.length > sampledCanvasSignatureReceipts.length,
         canvas_signature: sampledCanvasSignatureReceipts,
@@ -891,12 +914,27 @@ function normalizeSetupAction(input, index) {
   if ((type === "click" || type === "drag" || type === "fill" || type === "set_input_value" || type === "set_range_value" || type === "canvas_signature" || 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 fromX = type === "click" ? numberValue(valueFromOwn(input, "from_x", "fromX", "x", "click_x", "clickX", "start_x", "startX", "x1")) : numberValue(valueFromOwn(input, "from_x", "fromX", "start_x", "startX", "x1"));
+  const fromY = type === "click" ? numberValue(valueFromOwn(input, "from_y", "fromY", "y", "click_y", "clickY", "start_y", "startY", "y1")) : 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);
   const pointerType = normalizeSetupActionPointerType(valueFromOwn(input, "pointer_type", "pointerType", "input_type", "inputType"), type, index);
+  if (type === "click") {
+    const hasClickCoordinate = fromX !== void 0 || fromY !== void 0;
+    if (hasClickCoordinate && (fromX === void 0 || fromY === void 0)) {
+      throw new Error(`target.setup_actions[${index}] click coordinates require both x and y.`);
+    }
+    if (hasClickCoordinate && fromX !== void 0 && fromY !== void 0) {
+      const clickCoordinates = [fromX, fromY];
+      if (coordinateMode === "ratio" && clickCoordinates.some((value2) => value2 < 0 || value2 > 1)) {
+        throw new Error(`target.setup_actions[${index}] click ratio coordinates must be between 0 and 1.`);
+      }
+      if ((coordinateMode === void 0 || coordinateMode === "pixels") && clickCoordinates.some((value2) => value2 < 0)) {
+        throw new Error(`target.setup_actions[${index}] click pixel coordinates must be non-negative.`);
+      }
+    }
+  }
   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.`);
@@ -4166,6 +4204,26 @@ function profileSetupRangeValueReceipts(results) {
       reason: result.reason || result.error || null,
     }));
 }
+function profileSetupDragReceipts(results) {
+  return (results || [])
+    .filter((result) => result && profileSetupResultAction(result) === "drag")
+    .map((result) => ({
+      ordinal: result.ordinal ?? null,
+      ok: result.ok !== false,
+      selector: result.selector ?? null,
+      frame_selector: result.frame_selector ?? null,
+      pointer_type: result.pointer_type ?? null,
+      input_dispatch: result.input_dispatch ?? null,
+      coordinate_mode: result.coordinate_mode ?? null,
+      from_x: result.from_x ?? null,
+      from_y: result.from_y ?? null,
+      to_x: result.to_x ?? null,
+      to_y: result.to_y ?? null,
+      steps: result.steps ?? null,
+      duration_ms: result.duration_ms ?? null,
+      reason: result.reason || result.error || null,
+    }));
+}
 function profileSetupCanvasSignatureReceipts(results) {
   return (results || [])
     .filter((result) => result && profileSetupResultAction(result) === "canvas_signature")
@@ -4288,6 +4346,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
       const sampledWindowEvalReceipts = sampleProfileSetupSummaryItems(windowEvalReceipts, 8);
       const rangeValueReceipts = profileSetupRangeValueReceipts(results);
       const sampledRangeValueReceipts = sampleProfileSetupSummaryItems(rangeValueReceipts, 8);
+      const dragReceipts = profileSetupDragReceipts(results);
+      const sampledDragReceipts = sampleProfileSetupSummaryItems(dragReceipts, 8);
       const canvasSignatureReceipts = profileSetupCanvasSignatureReceipts(results);
       const sampledCanvasSignatureReceipts = sampleProfileSetupSummaryItems(canvasSignatureReceipts, 8);
       const clickedItems = results
@@ -4351,6 +4411,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         set_range_value_total: rangeValueReceipts.length,
         set_range_value_truncated: rangeValueReceipts.length > sampledRangeValueReceipts.length,
         set_range_value: sampledRangeValueReceipts,
+        drag_total: dragReceipts.length,
+        drag_truncated: dragReceipts.length > sampledDragReceipts.length,
+        drag: sampledDragReceipts,
         canvas_signature_total: canvasSignatureReceipts.length,
         canvas_signature_truncated: canvasSignatureReceipts.length > sampledCanvasSignatureReceipts.length,
         canvas_signature: sampledCanvasSignatureReceipts,
@@ -6329,8 +6392,35 @@ async function executeSetupAction(action, ordinal, viewport) {
         : { timeout, noWaitAfter: true };
       const clickCount = setupNumber(action.click_count, 1);
       if (Number.isInteger(clickCount) && clickCount > 1) clickOptions.clickCount = clickCount;
+      const fromX = setupFiniteNumber(action.from_x ?? action.fromX ?? action.x ?? action.click_x ?? action.clickX);
+      const fromY = setupFiniteNumber(action.from_y ?? action.fromY ?? action.y ?? action.click_y ?? action.clickY);
+      const hasClickPosition = fromX !== undefined || fromY !== undefined;
+      let position;
+      let mode;
+      if (hasClickPosition) {
+        if (fromX === undefined || fromY === undefined) return { ...base, ...setupScopeEvidence(scope), reason: "missing_click_coordinates", count, target_index: targetIndex };
+        const target = locator.nth(targetIndex);
+        const box = await target.boundingBox();
+        if (!box) return { ...base, ...setupScopeEvidence(scope), reason: "bounding_box_unavailable", count, target_index: targetIndex };
+        mode = String(action.coordinate_mode || action.coordinateMode || "pixels").trim();
+        const coordinate = (value, size) => mode === "ratio" ? value * size : value;
+        position = { x: coordinate(fromX, box.width), y: coordinate(fromY, box.height) };
+        clickOptions.position = position;
+      }
       await locator.nth(targetIndex).click(clickOptions);
-      return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined, click_count: clickCount > 1 ? clickCount : undefined };
+      return {
+        ...base,
+        ...setupScopeEvidence(scope),
+        ok: true,
+        count,
+        target_index: targetIndex,
+        text: matchedText,
+        force: action.force === true || undefined,
+        click_count: clickCount > 1 ? clickCount : undefined,
+        coordinate_mode: mode,
+        x: position ? fromX : undefined,
+        y: position ? fromY : undefined,
+      };
     }
     if (type === "fill" || type === "set_input_value") {
       const scope = await setupActionScope(action, timeout);

package/dist/cli.cjs

@@ -7508,6 +7508,24 @@ function profileSetupRangeValueReceipts(results) {
     reason: result.reason ?? result.error ?? null
   }));
 }
+function profileSetupDragReceipts(results) {
+  return results.filter((result) => profileSetupResultAction(result) === "drag").map((result) => ({
+    ordinal: result.ordinal ?? null,
+    ok: result.ok !== false,
+    selector: result.selector ?? null,
+    frame_selector: result.frame_selector ?? null,
+    pointer_type: result.pointer_type ?? null,
+    input_dispatch: result.input_dispatch ?? null,
+    coordinate_mode: result.coordinate_mode ?? null,
+    from_x: result.from_x ?? null,
+    from_y: result.from_y ?? null,
+    to_x: result.to_x ?? null,
+    to_y: result.to_y ?? null,
+    steps: result.steps ?? null,
+    duration_ms: result.duration_ms ?? null,
+    reason: result.reason ?? result.error ?? null
+  }));
+}
 function profileSetupCanvasSignatureReceipts(results) {
   return results.filter((result) => profileSetupResultAction(result) === "canvas_signature").map((result) => ({
     ordinal: result.ordinal ?? null,
@@ -7607,6 +7625,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
       const sampledWindowEvalReceipts = sampleProfileSetupSummaryItems(windowEvalReceipts, 8);
       const rangeValueReceipts = profileSetupRangeValueReceipts(results);
       const sampledRangeValueReceipts = sampleProfileSetupSummaryItems(rangeValueReceipts, 8);
+      const dragReceipts = profileSetupDragReceipts(results);
+      const sampledDragReceipts = sampleProfileSetupSummaryItems(dragReceipts, 8);
       const canvasSignatureReceipts = profileSetupCanvasSignatureReceipts(results);
       const sampledCanvasSignatureReceipts = sampleProfileSetupSummaryItems(canvasSignatureReceipts, 8);
       const clickedItems = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => {
@@ -7660,6 +7680,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
         set_range_value_total: rangeValueReceipts.length,
         set_range_value_truncated: rangeValueReceipts.length > sampledRangeValueReceipts.length,
         set_range_value: sampledRangeValueReceipts,
+        drag_total: dragReceipts.length,
+        drag_truncated: dragReceipts.length > sampledDragReceipts.length,
+        drag: sampledDragReceipts,
         canvas_signature_total: canvasSignatureReceipts.length,
         canvas_signature_truncated: canvasSignatureReceipts.length > sampledCanvasSignatureReceipts.length,
         canvas_signature: sampledCanvasSignatureReceipts,
@@ -7848,12 +7871,27 @@ function normalizeSetupAction(input, index) {
   if ((type === "click" || type === "drag" || type === "fill" || type === "set_input_value" || type === "set_range_value" || type === "canvas_signature" || 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 fromX = type === "click" ? numberValue(valueFromOwn(input, "from_x", "fromX", "x", "click_x", "clickX", "start_x", "startX", "x1")) : numberValue(valueFromOwn(input, "from_x", "fromX", "start_x", "startX", "x1"));
+  const fromY = type === "click" ? numberValue(valueFromOwn(input, "from_y", "fromY", "y", "click_y", "clickY", "start_y", "startY", "y1")) : 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);
   const pointerType = normalizeSetupActionPointerType(valueFromOwn(input, "pointer_type", "pointerType", "input_type", "inputType"), type, index);
+  if (type === "click") {
+    const hasClickCoordinate = fromX !== void 0 || fromY !== void 0;
+    if (hasClickCoordinate && (fromX === void 0 || fromY === void 0)) {
+      throw new Error(`target.setup_actions[${index}] click coordinates require both x and y.`);
+    }
+    if (hasClickCoordinate && fromX !== void 0 && fromY !== void 0) {
+      const clickCoordinates = [fromX, fromY];
+      if (coordinateMode === "ratio" && clickCoordinates.some((value2) => value2 < 0 || value2 > 1)) {
+        throw new Error(`target.setup_actions[${index}] click ratio coordinates must be between 0 and 1.`);
+      }
+      if ((coordinateMode === void 0 || coordinateMode === "pixels") && clickCoordinates.some((value2) => value2 < 0)) {
+        throw new Error(`target.setup_actions[${index}] click pixel coordinates must be non-negative.`);
+      }
+    }
+  }
   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.`);
@@ -11107,6 +11145,26 @@ function profileSetupRangeValueReceipts(results) {
       reason: result.reason || result.error || null,
     }));
 }
+function profileSetupDragReceipts(results) {
+  return (results || [])
+    .filter((result) => result && profileSetupResultAction(result) === "drag")
+    .map((result) => ({
+      ordinal: result.ordinal ?? null,
+      ok: result.ok !== false,
+      selector: result.selector ?? null,
+      frame_selector: result.frame_selector ?? null,
+      pointer_type: result.pointer_type ?? null,
+      input_dispatch: result.input_dispatch ?? null,
+      coordinate_mode: result.coordinate_mode ?? null,
+      from_x: result.from_x ?? null,
+      from_y: result.from_y ?? null,
+      to_x: result.to_x ?? null,
+      to_y: result.to_y ?? null,
+      steps: result.steps ?? null,
+      duration_ms: result.duration_ms ?? null,
+      reason: result.reason || result.error || null,
+    }));
+}
 function profileSetupCanvasSignatureReceipts(results) {
   return (results || [])
     .filter((result) => result && profileSetupResultAction(result) === "canvas_signature")
@@ -11229,6 +11287,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
       const sampledWindowEvalReceipts = sampleProfileSetupSummaryItems(windowEvalReceipts, 8);
       const rangeValueReceipts = profileSetupRangeValueReceipts(results);
       const sampledRangeValueReceipts = sampleProfileSetupSummaryItems(rangeValueReceipts, 8);
+      const dragReceipts = profileSetupDragReceipts(results);
+      const sampledDragReceipts = sampleProfileSetupSummaryItems(dragReceipts, 8);
       const canvasSignatureReceipts = profileSetupCanvasSignatureReceipts(results);
       const sampledCanvasSignatureReceipts = sampleProfileSetupSummaryItems(canvasSignatureReceipts, 8);
       const clickedItems = results
@@ -11292,6 +11352,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         set_range_value_total: rangeValueReceipts.length,
         set_range_value_truncated: rangeValueReceipts.length > sampledRangeValueReceipts.length,
         set_range_value: sampledRangeValueReceipts,
+        drag_total: dragReceipts.length,
+        drag_truncated: dragReceipts.length > sampledDragReceipts.length,
+        drag: sampledDragReceipts,
         canvas_signature_total: canvasSignatureReceipts.length,
         canvas_signature_truncated: canvasSignatureReceipts.length > sampledCanvasSignatureReceipts.length,
         canvas_signature: sampledCanvasSignatureReceipts,
@@ -13270,8 +13333,35 @@ async function executeSetupAction(action, ordinal, viewport) {
         : { timeout, noWaitAfter: true };
       const clickCount = setupNumber(action.click_count, 1);
       if (Number.isInteger(clickCount) && clickCount > 1) clickOptions.clickCount = clickCount;
+      const fromX = setupFiniteNumber(action.from_x ?? action.fromX ?? action.x ?? action.click_x ?? action.clickX);
+      const fromY = setupFiniteNumber(action.from_y ?? action.fromY ?? action.y ?? action.click_y ?? action.clickY);
+      const hasClickPosition = fromX !== undefined || fromY !== undefined;
+      let position;
+      let mode;
+      if (hasClickPosition) {
+        if (fromX === undefined || fromY === undefined) return { ...base, ...setupScopeEvidence(scope), reason: "missing_click_coordinates", count, target_index: targetIndex };
+        const target = locator.nth(targetIndex);
+        const box = await target.boundingBox();
+        if (!box) return { ...base, ...setupScopeEvidence(scope), reason: "bounding_box_unavailable", count, target_index: targetIndex };
+        mode = String(action.coordinate_mode || action.coordinateMode || "pixels").trim();
+        const coordinate = (value, size) => mode === "ratio" ? value * size : value;
+        position = { x: coordinate(fromX, box.width), y: coordinate(fromY, box.height) };
+        clickOptions.position = position;
+      }
       await locator.nth(targetIndex).click(clickOptions);
-      return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined, click_count: clickCount > 1 ? clickCount : undefined };
+      return {
+        ...base,
+        ...setupScopeEvidence(scope),
+        ok: true,
+        count,
+        target_index: targetIndex,
+        text: matchedText,
+        force: action.force === true || undefined,
+        click_count: clickCount > 1 ? clickCount : undefined,
+        coordinate_mode: mode,
+        x: position ? fromX : undefined,
+        y: position ? fromY : undefined,
+      };
     }
     if (type === "fill" || type === "set_input_value") {
       const scope = await setupActionScope(action, timeout);
@@ -15864,6 +15954,7 @@ function profileSetupSummaryMarkdown(result) {
   const windowCallUntilTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.window_call_until_total) || 0), 0);
   const windowCallUntilCallTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.window_call_until_call_total) || 0), 0);
   const rangeValueTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.set_range_value_total) || 0), 0);
+  const dragTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.drag_total) || 0), 0);
   const canvasSignatureTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.canvas_signature_total) || 0), 0);
   const failedTotal = viewports.reduce((sum, viewport) => sum + (Array.isArray(viewport.failed) ? viewport.failed.length : 0), 0);
   const lines = [
@@ -15887,6 +15978,9 @@ function profileSetupSummaryMarkdown(result) {
   if (rangeValueTotal) {
     lines.push(`- set_range_value: ${rangeValueTotal} action(s)`);
   }
+  if (dragTotal) {
+    lines.push(`- drag: ${dragTotal} action(s)`);
+  }
   if (canvasSignatureTotal) {
     lines.push(`- canvas_signature: ${canvasSignatureTotal} action(s)`);
   }
@@ -15906,10 +16000,35 @@ function profileSetupSummaryMarkdown(result) {
     const windowCallUntilActions = cliFiniteNumber(viewport.window_call_until_total) || 0;
     const windowCallUntilCalls = cliFiniteNumber(viewport.window_call_until_call_total) || 0;
     const rangeValueActions = cliFiniteNumber(viewport.set_range_value_total) || 0;
+    const dragActions = cliFiniteNumber(viewport.drag_total) || 0;
     const canvasSignatureActions = cliFiniteNumber(viewport.canvas_signature_total) || 0;
     const observedPath = cliString(viewport.observed_path);
-    lines.push(`- ${name}: ${ok}, ${resultCount} result(s), ${screenshotCount} setup screenshot(s), ${clicked} click(s)${clickCountActions ? `, ${clickCountActions} click_count action(s)` : ""}${rangeValueActions ? `, ${rangeValueActions} set_range_value action(s)` : ""}${canvasSignatureActions ? `, ${canvasSignatureActions} canvas_signature action(s)` : ""}${windowCallActions ? `, ${windowCallActions} window_call action(s), ${windowCallStored} stored return(s), ${windowCallCaptured} captured return(s)` : ""}${windowEvalActions ? `, ${windowEvalActions} window_eval action(s), ${windowEvalStored} stored return(s), ${windowEvalCaptured} captured return(s)` : ""}${windowCallUntilActions ? `, ${windowCallUntilActions} window_call_until action(s), ${windowCallUntilCalls} call(s)` : ""}${observedPath ? `, path ${observedPath}` : ""}`);
+    lines.push(`- ${name}: ${ok}, ${resultCount} result(s), ${screenshotCount} setup screenshot(s), ${clicked} click(s)${clickCountActions ? `, ${clickCountActions} click_count action(s)` : ""}${rangeValueActions ? `, ${rangeValueActions} set_range_value action(s)` : ""}${dragActions ? `, ${dragActions} drag action(s)` : ""}${canvasSignatureActions ? `, ${canvasSignatureActions} canvas_signature action(s)` : ""}${windowCallActions ? `, ${windowCallActions} window_call action(s), ${windowCallStored} stored return(s), ${windowCallCaptured} captured return(s)` : ""}${windowEvalActions ? `, ${windowEvalActions} window_eval action(s), ${windowEvalStored} stored return(s), ${windowEvalCaptured} captured return(s)` : ""}${windowCallUntilActions ? `, ${windowCallUntilActions} window_call_until action(s), ${windowCallUntilCalls} call(s)` : ""}${observedPath ? `, path ${observedPath}` : ""}`);
+  }
+  const dragGroups = viewports.map((viewport) => {
+    const name = cliString(viewport.name) || "viewport";
+    const receipts = Array.isArray(viewport.drag) ? viewport.drag.map(cliRecord).filter((item) => Boolean(item)) : [];
+    return receipts.map((receipt) => ({ name, receipt }));
+  });
+  const dragDetails = dragGroups.flat();
+  const sampledDragDetails = balancedSetupReceiptDetails(dragGroups, 12);
+  for (const { name, receipt } of sampledDragDetails) {
+    const selector = cliString(receipt.selector) || "target";
+    const pointerType = cliString(receipt.pointer_type);
+    const inputDispatch = cliString(receipt.input_dispatch);
+    const coordinateMode = cliString(receipt.coordinate_mode);
+    const fromX = cliValueLabel(receipt.from_x);
+    const fromY = cliValueLabel(receipt.from_y);
+    const toX = cliValueLabel(receipt.to_x);
+    const toY = cliValueLabel(receipt.to_y);
+    const steps = cliFiniteNumber(receipt.steps);
+    const durationMs = cliFiniteNumber(receipt.duration_ms);
+    const ok = receipt.ok === false ? "failed" : "ok";
+    const reason = cliString(receipt.reason);
+    const coordinateText = fromX && fromY && toX && toY ? `, ${coordinateMode ? `${coordinateMode} ` : ""}${markdownInlineCode(`${fromX},${fromY}`)} -> ${markdownInlineCode(`${toX},${toY}`)}` : "";
+    lines.push(`- ${name} drag: ${ok}, ${markdownInlineCode(selector)}${pointerType ? ` ${markdownInlineCode(pointerType)}` : ""}${inputDispatch ? ` via ${markdownInlineCode(inputDispatch)}` : ""}${coordinateText}${steps === void 0 ? "" : `, steps ${steps}`}${durationMs === void 0 ? "" : `, duration ${durationMs}ms`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
   }
+  if (dragDetails.length > sampledDragDetails.length) lines.push(`- ${dragDetails.length - sampledDragDetails.length} additional drag receipt(s) omitted.`);
   const canvasSignatureGroups = viewports.map((viewport) => {
     const name = cliString(viewport.name) || "viewport";
     const receipts = Array.isArray(viewport.canvas_signature) ? viewport.canvas_signature.map(cliRecord).filter((item) => Boolean(item)) : [];

package/dist/cli.js

@@ -13,7 +13,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-RXJ7YQBJ.js";
+} from "./chunk-L6WJP5IY.js";
 import {
   createRiddleApiClient,
   isTerminalRiddleJobStatus,
@@ -787,6 +787,7 @@ function profileSetupSummaryMarkdown(result) {
   const windowCallUntilTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.window_call_until_total) || 0), 0);
   const windowCallUntilCallTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.window_call_until_call_total) || 0), 0);
   const rangeValueTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.set_range_value_total) || 0), 0);
+  const dragTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.drag_total) || 0), 0);
   const canvasSignatureTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.canvas_signature_total) || 0), 0);
   const failedTotal = viewports.reduce((sum, viewport) => sum + (Array.isArray(viewport.failed) ? viewport.failed.length : 0), 0);
   const lines = [
@@ -810,6 +811,9 @@ function profileSetupSummaryMarkdown(result) {
   if (rangeValueTotal) {
     lines.push(`- set_range_value: ${rangeValueTotal} action(s)`);
   }
+  if (dragTotal) {
+    lines.push(`- drag: ${dragTotal} action(s)`);
+  }
   if (canvasSignatureTotal) {
     lines.push(`- canvas_signature: ${canvasSignatureTotal} action(s)`);
   }
@@ -829,10 +833,35 @@ function profileSetupSummaryMarkdown(result) {
     const windowCallUntilActions = cliFiniteNumber(viewport.window_call_until_total) || 0;
     const windowCallUntilCalls = cliFiniteNumber(viewport.window_call_until_call_total) || 0;
     const rangeValueActions = cliFiniteNumber(viewport.set_range_value_total) || 0;
+    const dragActions = cliFiniteNumber(viewport.drag_total) || 0;
     const canvasSignatureActions = cliFiniteNumber(viewport.canvas_signature_total) || 0;
     const observedPath = cliString(viewport.observed_path);
-    lines.push(`- ${name}: ${ok}, ${resultCount} result(s), ${screenshotCount} setup screenshot(s), ${clicked} click(s)${clickCountActions ? `, ${clickCountActions} click_count action(s)` : ""}${rangeValueActions ? `, ${rangeValueActions} set_range_value action(s)` : ""}${canvasSignatureActions ? `, ${canvasSignatureActions} canvas_signature action(s)` : ""}${windowCallActions ? `, ${windowCallActions} window_call action(s), ${windowCallStored} stored return(s), ${windowCallCaptured} captured return(s)` : ""}${windowEvalActions ? `, ${windowEvalActions} window_eval action(s), ${windowEvalStored} stored return(s), ${windowEvalCaptured} captured return(s)` : ""}${windowCallUntilActions ? `, ${windowCallUntilActions} window_call_until action(s), ${windowCallUntilCalls} call(s)` : ""}${observedPath ? `, path ${observedPath}` : ""}`);
+    lines.push(`- ${name}: ${ok}, ${resultCount} result(s), ${screenshotCount} setup screenshot(s), ${clicked} click(s)${clickCountActions ? `, ${clickCountActions} click_count action(s)` : ""}${rangeValueActions ? `, ${rangeValueActions} set_range_value action(s)` : ""}${dragActions ? `, ${dragActions} drag action(s)` : ""}${canvasSignatureActions ? `, ${canvasSignatureActions} canvas_signature action(s)` : ""}${windowCallActions ? `, ${windowCallActions} window_call action(s), ${windowCallStored} stored return(s), ${windowCallCaptured} captured return(s)` : ""}${windowEvalActions ? `, ${windowEvalActions} window_eval action(s), ${windowEvalStored} stored return(s), ${windowEvalCaptured} captured return(s)` : ""}${windowCallUntilActions ? `, ${windowCallUntilActions} window_call_until action(s), ${windowCallUntilCalls} call(s)` : ""}${observedPath ? `, path ${observedPath}` : ""}`);
+  }
+  const dragGroups = viewports.map((viewport) => {
+    const name = cliString(viewport.name) || "viewport";
+    const receipts = Array.isArray(viewport.drag) ? viewport.drag.map(cliRecord).filter((item) => Boolean(item)) : [];
+    return receipts.map((receipt) => ({ name, receipt }));
+  });
+  const dragDetails = dragGroups.flat();
+  const sampledDragDetails = balancedSetupReceiptDetails(dragGroups, 12);
+  for (const { name, receipt } of sampledDragDetails) {
+    const selector = cliString(receipt.selector) || "target";
+    const pointerType = cliString(receipt.pointer_type);
+    const inputDispatch = cliString(receipt.input_dispatch);
+    const coordinateMode = cliString(receipt.coordinate_mode);
+    const fromX = cliValueLabel(receipt.from_x);
+    const fromY = cliValueLabel(receipt.from_y);
+    const toX = cliValueLabel(receipt.to_x);
+    const toY = cliValueLabel(receipt.to_y);
+    const steps = cliFiniteNumber(receipt.steps);
+    const durationMs = cliFiniteNumber(receipt.duration_ms);
+    const ok = receipt.ok === false ? "failed" : "ok";
+    const reason = cliString(receipt.reason);
+    const coordinateText = fromX && fromY && toX && toY ? `, ${coordinateMode ? `${coordinateMode} ` : ""}${markdownInlineCode(`${fromX},${fromY}`)} -> ${markdownInlineCode(`${toX},${toY}`)}` : "";
+    lines.push(`- ${name} drag: ${ok}, ${markdownInlineCode(selector)}${pointerType ? ` ${markdownInlineCode(pointerType)}` : ""}${inputDispatch ? ` via ${markdownInlineCode(inputDispatch)}` : ""}${coordinateText}${steps === void 0 ? "" : `, steps ${steps}`}${durationMs === void 0 ? "" : `, duration ${durationMs}ms`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
   }
+  if (dragDetails.length > sampledDragDetails.length) lines.push(`- ${dragDetails.length - sampledDragDetails.length} additional drag receipt(s) omitted.`);
   const canvasSignatureGroups = viewports.map((viewport) => {
     const name = cliString(viewport.name) || "viewport";
     const receipts = Array.isArray(viewport.canvas_signature) ? viewport.canvas_signature.map(cliRecord).filter((item) => Boolean(item)) : [];

package/dist/index.cjs

@@ -9284,6 +9284,24 @@ function profileSetupRangeValueReceipts(results) {
     reason: result.reason ?? result.error ?? null
   }));
 }
+function profileSetupDragReceipts(results) {
+  return results.filter((result) => profileSetupResultAction(result) === "drag").map((result) => ({
+    ordinal: result.ordinal ?? null,
+    ok: result.ok !== false,
+    selector: result.selector ?? null,
+    frame_selector: result.frame_selector ?? null,
+    pointer_type: result.pointer_type ?? null,
+    input_dispatch: result.input_dispatch ?? null,
+    coordinate_mode: result.coordinate_mode ?? null,
+    from_x: result.from_x ?? null,
+    from_y: result.from_y ?? null,
+    to_x: result.to_x ?? null,
+    to_y: result.to_y ?? null,
+    steps: result.steps ?? null,
+    duration_ms: result.duration_ms ?? null,
+    reason: result.reason ?? result.error ?? null
+  }));
+}
 function profileSetupCanvasSignatureReceipts(results) {
   return results.filter((result) => profileSetupResultAction(result) === "canvas_signature").map((result) => ({
     ordinal: result.ordinal ?? null,
@@ -9383,6 +9401,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
       const sampledWindowEvalReceipts = sampleProfileSetupSummaryItems(windowEvalReceipts, 8);
       const rangeValueReceipts = profileSetupRangeValueReceipts(results);
       const sampledRangeValueReceipts = sampleProfileSetupSummaryItems(rangeValueReceipts, 8);
+      const dragReceipts = profileSetupDragReceipts(results);
+      const sampledDragReceipts = sampleProfileSetupSummaryItems(dragReceipts, 8);
       const canvasSignatureReceipts = profileSetupCanvasSignatureReceipts(results);
       const sampledCanvasSignatureReceipts = sampleProfileSetupSummaryItems(canvasSignatureReceipts, 8);
       const clickedItems = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => {
@@ -9436,6 +9456,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
         set_range_value_total: rangeValueReceipts.length,
         set_range_value_truncated: rangeValueReceipts.length > sampledRangeValueReceipts.length,
         set_range_value: sampledRangeValueReceipts,
+        drag_total: dragReceipts.length,
+        drag_truncated: dragReceipts.length > sampledDragReceipts.length,
+        drag: sampledDragReceipts,
         canvas_signature_total: canvasSignatureReceipts.length,
         canvas_signature_truncated: canvasSignatureReceipts.length > sampledCanvasSignatureReceipts.length,
         canvas_signature: sampledCanvasSignatureReceipts,
@@ -9624,12 +9647,27 @@ function normalizeSetupAction(input, index) {
   if ((type === "click" || type === "drag" || type === "fill" || type === "set_input_value" || type === "set_range_value" || type === "canvas_signature" || 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 fromX = type === "click" ? numberValue3(valueFromOwn(input, "from_x", "fromX", "x", "click_x", "clickX", "start_x", "startX", "x1")) : numberValue3(valueFromOwn(input, "from_x", "fromX", "start_x", "startX", "x1"));
+  const fromY = type === "click" ? numberValue3(valueFromOwn(input, "from_y", "fromY", "y", "click_y", "clickY", "start_y", "startY", "y1")) : 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);
   const pointerType = normalizeSetupActionPointerType(valueFromOwn(input, "pointer_type", "pointerType", "input_type", "inputType"), type, index);
+  if (type === "click") {
+    const hasClickCoordinate = fromX !== void 0 || fromY !== void 0;
+    if (hasClickCoordinate && (fromX === void 0 || fromY === void 0)) {
+      throw new Error(`target.setup_actions[${index}] click coordinates require both x and y.`);
+    }
+    if (hasClickCoordinate && fromX !== void 0 && fromY !== void 0) {
+      const clickCoordinates = [fromX, fromY];
+      if (coordinateMode === "ratio" && clickCoordinates.some((value2) => value2 < 0 || value2 > 1)) {
+        throw new Error(`target.setup_actions[${index}] click ratio coordinates must be between 0 and 1.`);
+      }
+      if ((coordinateMode === void 0 || coordinateMode === "pixels") && clickCoordinates.some((value2) => value2 < 0)) {
+        throw new Error(`target.setup_actions[${index}] click pixel coordinates must be non-negative.`);
+      }
+    }
+  }
   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.`);
@@ -12899,6 +12937,26 @@ function profileSetupRangeValueReceipts(results) {
       reason: result.reason || result.error || null,
     }));
 }
+function profileSetupDragReceipts(results) {
+  return (results || [])
+    .filter((result) => result && profileSetupResultAction(result) === "drag")
+    .map((result) => ({
+      ordinal: result.ordinal ?? null,
+      ok: result.ok !== false,
+      selector: result.selector ?? null,
+      frame_selector: result.frame_selector ?? null,
+      pointer_type: result.pointer_type ?? null,
+      input_dispatch: result.input_dispatch ?? null,
+      coordinate_mode: result.coordinate_mode ?? null,
+      from_x: result.from_x ?? null,
+      from_y: result.from_y ?? null,
+      to_x: result.to_x ?? null,
+      to_y: result.to_y ?? null,
+      steps: result.steps ?? null,
+      duration_ms: result.duration_ms ?? null,
+      reason: result.reason || result.error || null,
+    }));
+}
 function profileSetupCanvasSignatureReceipts(results) {
   return (results || [])
     .filter((result) => result && profileSetupResultAction(result) === "canvas_signature")
@@ -13021,6 +13079,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
       const sampledWindowEvalReceipts = sampleProfileSetupSummaryItems(windowEvalReceipts, 8);
       const rangeValueReceipts = profileSetupRangeValueReceipts(results);
       const sampledRangeValueReceipts = sampleProfileSetupSummaryItems(rangeValueReceipts, 8);
+      const dragReceipts = profileSetupDragReceipts(results);
+      const sampledDragReceipts = sampleProfileSetupSummaryItems(dragReceipts, 8);
       const canvasSignatureReceipts = profileSetupCanvasSignatureReceipts(results);
       const sampledCanvasSignatureReceipts = sampleProfileSetupSummaryItems(canvasSignatureReceipts, 8);
       const clickedItems = results
@@ -13084,6 +13144,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         set_range_value_total: rangeValueReceipts.length,
         set_range_value_truncated: rangeValueReceipts.length > sampledRangeValueReceipts.length,
         set_range_value: sampledRangeValueReceipts,
+        drag_total: dragReceipts.length,
+        drag_truncated: dragReceipts.length > sampledDragReceipts.length,
+        drag: sampledDragReceipts,
         canvas_signature_total: canvasSignatureReceipts.length,
         canvas_signature_truncated: canvasSignatureReceipts.length > sampledCanvasSignatureReceipts.length,
         canvas_signature: sampledCanvasSignatureReceipts,
@@ -15062,8 +15125,35 @@ async function executeSetupAction(action, ordinal, viewport) {
         : { timeout, noWaitAfter: true };
       const clickCount = setupNumber(action.click_count, 1);
       if (Number.isInteger(clickCount) && clickCount > 1) clickOptions.clickCount = clickCount;
+      const fromX = setupFiniteNumber(action.from_x ?? action.fromX ?? action.x ?? action.click_x ?? action.clickX);
+      const fromY = setupFiniteNumber(action.from_y ?? action.fromY ?? action.y ?? action.click_y ?? action.clickY);
+      const hasClickPosition = fromX !== undefined || fromY !== undefined;
+      let position;
+      let mode;
+      if (hasClickPosition) {
+        if (fromX === undefined || fromY === undefined) return { ...base, ...setupScopeEvidence(scope), reason: "missing_click_coordinates", count, target_index: targetIndex };
+        const target = locator.nth(targetIndex);
+        const box = await target.boundingBox();
+        if (!box) return { ...base, ...setupScopeEvidence(scope), reason: "bounding_box_unavailable", count, target_index: targetIndex };
+        mode = String(action.coordinate_mode || action.coordinateMode || "pixels").trim();
+        const coordinate = (value, size) => mode === "ratio" ? value * size : value;
+        position = { x: coordinate(fromX, box.width), y: coordinate(fromY, box.height) };
+        clickOptions.position = position;
+      }
       await locator.nth(targetIndex).click(clickOptions);
-      return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined, click_count: clickCount > 1 ? clickCount : undefined };
+      return {
+        ...base,
+        ...setupScopeEvidence(scope),
+        ok: true,
+        count,
+        target_index: targetIndex,
+        text: matchedText,
+        force: action.force === true || undefined,
+        click_count: clickCount > 1 ? clickCount : undefined,
+        coordinate_mode: mode,
+        x: position ? fromX : undefined,
+        y: position ? fromY : undefined,
+      };
     }
     if (type === "fill" || type === "set_input_value") {
       const scope = await setupActionScope(action, timeout);

package/dist/index.js

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

package/dist/profile.cjs

@@ -598,6 +598,24 @@ function profileSetupRangeValueReceipts(results) {
     reason: result.reason ?? result.error ?? null
   }));
 }
+function profileSetupDragReceipts(results) {
+  return results.filter((result) => profileSetupResultAction(result) === "drag").map((result) => ({
+    ordinal: result.ordinal ?? null,
+    ok: result.ok !== false,
+    selector: result.selector ?? null,
+    frame_selector: result.frame_selector ?? null,
+    pointer_type: result.pointer_type ?? null,
+    input_dispatch: result.input_dispatch ?? null,
+    coordinate_mode: result.coordinate_mode ?? null,
+    from_x: result.from_x ?? null,
+    from_y: result.from_y ?? null,
+    to_x: result.to_x ?? null,
+    to_y: result.to_y ?? null,
+    steps: result.steps ?? null,
+    duration_ms: result.duration_ms ?? null,
+    reason: result.reason ?? result.error ?? null
+  }));
+}
 function profileSetupCanvasSignatureReceipts(results) {
   return results.filter((result) => profileSetupResultAction(result) === "canvas_signature").map((result) => ({
     ordinal: result.ordinal ?? null,
@@ -697,6 +715,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
       const sampledWindowEvalReceipts = sampleProfileSetupSummaryItems(windowEvalReceipts, 8);
       const rangeValueReceipts = profileSetupRangeValueReceipts(results);
       const sampledRangeValueReceipts = sampleProfileSetupSummaryItems(rangeValueReceipts, 8);
+      const dragReceipts = profileSetupDragReceipts(results);
+      const sampledDragReceipts = sampleProfileSetupSummaryItems(dragReceipts, 8);
       const canvasSignatureReceipts = profileSetupCanvasSignatureReceipts(results);
       const sampledCanvasSignatureReceipts = sampleProfileSetupSummaryItems(canvasSignatureReceipts, 8);
       const clickedItems = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => {
@@ -750,6 +770,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
         set_range_value_total: rangeValueReceipts.length,
         set_range_value_truncated: rangeValueReceipts.length > sampledRangeValueReceipts.length,
         set_range_value: sampledRangeValueReceipts,
+        drag_total: dragReceipts.length,
+        drag_truncated: dragReceipts.length > sampledDragReceipts.length,
+        drag: sampledDragReceipts,
         canvas_signature_total: canvasSignatureReceipts.length,
         canvas_signature_truncated: canvasSignatureReceipts.length > sampledCanvasSignatureReceipts.length,
         canvas_signature: sampledCanvasSignatureReceipts,
@@ -938,12 +961,27 @@ function normalizeSetupAction(input, index) {
   if ((type === "click" || type === "drag" || type === "fill" || type === "set_input_value" || type === "set_range_value" || type === "canvas_signature" || 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 fromX = type === "click" ? numberValue(valueFromOwn(input, "from_x", "fromX", "x", "click_x", "clickX", "start_x", "startX", "x1")) : numberValue(valueFromOwn(input, "from_x", "fromX", "start_x", "startX", "x1"));
+  const fromY = type === "click" ? numberValue(valueFromOwn(input, "from_y", "fromY", "y", "click_y", "clickY", "start_y", "startY", "y1")) : 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);
   const pointerType = normalizeSetupActionPointerType(valueFromOwn(input, "pointer_type", "pointerType", "input_type", "inputType"), type, index);
+  if (type === "click") {
+    const hasClickCoordinate = fromX !== void 0 || fromY !== void 0;
+    if (hasClickCoordinate && (fromX === void 0 || fromY === void 0)) {
+      throw new Error(`target.setup_actions[${index}] click coordinates require both x and y.`);
+    }
+    if (hasClickCoordinate && fromX !== void 0 && fromY !== void 0) {
+      const clickCoordinates = [fromX, fromY];
+      if (coordinateMode === "ratio" && clickCoordinates.some((value2) => value2 < 0 || value2 > 1)) {
+        throw new Error(`target.setup_actions[${index}] click ratio coordinates must be between 0 and 1.`);
+      }
+      if ((coordinateMode === void 0 || coordinateMode === "pixels") && clickCoordinates.some((value2) => value2 < 0)) {
+        throw new Error(`target.setup_actions[${index}] click pixel coordinates must be non-negative.`);
+      }
+    }
+  }
   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.`);
@@ -4213,6 +4251,26 @@ function profileSetupRangeValueReceipts(results) {
       reason: result.reason || result.error || null,
     }));
 }
+function profileSetupDragReceipts(results) {
+  return (results || [])
+    .filter((result) => result && profileSetupResultAction(result) === "drag")
+    .map((result) => ({
+      ordinal: result.ordinal ?? null,
+      ok: result.ok !== false,
+      selector: result.selector ?? null,
+      frame_selector: result.frame_selector ?? null,
+      pointer_type: result.pointer_type ?? null,
+      input_dispatch: result.input_dispatch ?? null,
+      coordinate_mode: result.coordinate_mode ?? null,
+      from_x: result.from_x ?? null,
+      from_y: result.from_y ?? null,
+      to_x: result.to_x ?? null,
+      to_y: result.to_y ?? null,
+      steps: result.steps ?? null,
+      duration_ms: result.duration_ms ?? null,
+      reason: result.reason || result.error || null,
+    }));
+}
 function profileSetupCanvasSignatureReceipts(results) {
   return (results || [])
     .filter((result) => result && profileSetupResultAction(result) === "canvas_signature")
@@ -4335,6 +4393,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
       const sampledWindowEvalReceipts = sampleProfileSetupSummaryItems(windowEvalReceipts, 8);
       const rangeValueReceipts = profileSetupRangeValueReceipts(results);
       const sampledRangeValueReceipts = sampleProfileSetupSummaryItems(rangeValueReceipts, 8);
+      const dragReceipts = profileSetupDragReceipts(results);
+      const sampledDragReceipts = sampleProfileSetupSummaryItems(dragReceipts, 8);
       const canvasSignatureReceipts = profileSetupCanvasSignatureReceipts(results);
       const sampledCanvasSignatureReceipts = sampleProfileSetupSummaryItems(canvasSignatureReceipts, 8);
       const clickedItems = results
@@ -4398,6 +4458,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         set_range_value_total: rangeValueReceipts.length,
         set_range_value_truncated: rangeValueReceipts.length > sampledRangeValueReceipts.length,
         set_range_value: sampledRangeValueReceipts,
+        drag_total: dragReceipts.length,
+        drag_truncated: dragReceipts.length > sampledDragReceipts.length,
+        drag: sampledDragReceipts,
         canvas_signature_total: canvasSignatureReceipts.length,
         canvas_signature_truncated: canvasSignatureReceipts.length > sampledCanvasSignatureReceipts.length,
         canvas_signature: sampledCanvasSignatureReceipts,
@@ -6376,8 +6439,35 @@ async function executeSetupAction(action, ordinal, viewport) {
         : { timeout, noWaitAfter: true };
       const clickCount = setupNumber(action.click_count, 1);
       if (Number.isInteger(clickCount) && clickCount > 1) clickOptions.clickCount = clickCount;
+      const fromX = setupFiniteNumber(action.from_x ?? action.fromX ?? action.x ?? action.click_x ?? action.clickX);
+      const fromY = setupFiniteNumber(action.from_y ?? action.fromY ?? action.y ?? action.click_y ?? action.clickY);
+      const hasClickPosition = fromX !== undefined || fromY !== undefined;
+      let position;
+      let mode;
+      if (hasClickPosition) {
+        if (fromX === undefined || fromY === undefined) return { ...base, ...setupScopeEvidence(scope), reason: "missing_click_coordinates", count, target_index: targetIndex };
+        const target = locator.nth(targetIndex);
+        const box = await target.boundingBox();
+        if (!box) return { ...base, ...setupScopeEvidence(scope), reason: "bounding_box_unavailable", count, target_index: targetIndex };
+        mode = String(action.coordinate_mode || action.coordinateMode || "pixels").trim();
+        const coordinate = (value, size) => mode === "ratio" ? value * size : value;
+        position = { x: coordinate(fromX, box.width), y: coordinate(fromY, box.height) };
+        clickOptions.position = position;
+      }
       await locator.nth(targetIndex).click(clickOptions);
-      return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined, click_count: clickCount > 1 ? clickCount : undefined };
+      return {
+        ...base,
+        ...setupScopeEvidence(scope),
+        ok: true,
+        count,
+        target_index: targetIndex,
+        text: matchedText,
+        force: action.force === true || undefined,
+        click_count: clickCount > 1 ? clickCount : undefined,
+        coordinate_mode: mode,
+        x: position ? fromX : undefined,
+        y: position ? fromY : undefined,
+      };
     }
     if (type === "fill" || type === "set_input_value") {
       const scope = await setupActionScope(action, timeout);

package/dist/profile.js

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