@riddledc/riddle-proof 0.7.68 → 0.7.70

package/README.md

@@ -272,6 +272,10 @@ 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 `click_count` / `clickCount` / `clicks` from 1 to 10 on a single `click`
+action for atomic double-click or double-submit contracts where modeling the
+interaction as repeated setup actions would incorrectly require the target to
+remain in the DOM after the first click.
 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:
@@ -314,7 +318,9 @@ setup screenshots, compact text samples, and failures so setup-heavy clickthroug
 can be reviewed without reading every raw setup-action result. Long click
 sequences include `clicked_total` and `clicked_truncated`; the compact `clicked`
 list keeps the first and last clicked targets so later route switches and reset
-actions stay visible.
+actions stay visible. Click actions with `click_count` greater than `1` are
+included in clicked-target evidence and rolled up as `click_count_action_total`
+and `click_count_value_total`.
 
 `target.timeout_sec` is optional. Use it for known-heavy profile targets so the
 profile carries its own hosted Riddle worker budget; an explicit CLI `--timeout`

package/dist/{chunk-376FPGFA.js → chunk-KMJBTFLI.js}

@@ -231,12 +231,18 @@ function profileSetupSummary(viewports, actionCount) {
     viewports: viewports.map((viewport) => {
       const results = viewport.setup_action_results || [];
       const failed = results.filter((result) => result.ok === false);
-      const clickedItems = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => ({
-        ordinal: result.ordinal ?? null,
-        selector: result.selector ?? null,
-        frame_selector: result.frame_selector ?? null,
-        text: compactProfileSetupSummaryText(result.text)
-      }));
+      const successfulClicks = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false);
+      const clickCountValues = successfulClicks.map((result) => typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : void 0).filter((value) => value !== void 0);
+      const clickedItems = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => {
+        const clickCount = typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : void 0;
+        return {
+          ordinal: result.ordinal ?? null,
+          selector: result.selector ?? null,
+          frame_selector: result.frame_selector ?? null,
+          text: compactProfileSetupSummaryText(result.text),
+          ...clickCount ? { click_count: clickCount } : {}
+        };
+      });
       const clicked = sampleProfileSetupSummaryItems(clickedItems, 8);
       const text_samples = results.filter((result) => result.ok !== false && typeof result.text === "string" && (profileSetupResultAction(result) === "assert_text_visible" || profileSetupResultAction(result) === "assert_text_absent" || profileSetupResultAction(result) === "wait_for_text")).map((result) => ({
         ordinal: result.ordinal ?? null,
@@ -256,6 +262,8 @@ function profileSetupSummary(viewports, actionCount) {
         setup_screenshots: profileSetupScreenshotLabels(results),
         clicked_total: clickedItems.length,
         clicked_truncated: clickedItems.length > clicked.length,
+        click_count_action_total: clickCountValues.length,
+        click_count_value_total: clickCountValues.reduce((sum, value) => sum + value, 0),
         clicked,
         text_samples,
         failed: failed.map((result) => ({
@@ -329,6 +337,18 @@ function normalizeSetupActionRepeat(input, index) {
   }
   return repeat;
 }
+function normalizeSetupActionClickCount(input, type, index) {
+  const clickCountInput = valueFromOwn(input, "click_count", "clickCount", "clicks");
+  if (clickCountInput === void 0) return void 0;
+  if (type !== "click") {
+    throw new Error(`target.setup_actions[${index}].click_count is only supported for click actions.`);
+  }
+  const clickCount = numberValue(clickCountInput);
+  if (clickCount === void 0 || !Number.isInteger(clickCount) || clickCount < 1 || clickCount > 10) {
+    throw new Error(`target.setup_actions[${index}].click_count must be an integer from 1 to 10.`);
+  }
+  return clickCount;
+}
 function normalizeSetupActionCoordinateMode(value, index) {
   if (value === void 0 || value === null || value === "") return void 0;
   const normalized = String(value).trim().replace(/-/g, "_").toLowerCase();
@@ -420,6 +440,7 @@ function normalizeSetupAction(input, index) {
     frame_selector: frameSelector,
     frame_index: frameIndex,
     force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
+    click_count: normalizeSetupActionClickCount(input, type, index),
     coordinate_mode: coordinateMode,
     from_x: fromX,
     from_y: fromY,
@@ -1883,14 +1904,22 @@ function profileSetupSummary(viewports, actionCount) {
     viewports: (viewports || []).map((viewport) => {
       const results = viewport.setup_action_results || [];
       const failed = results.filter((result) => result && result.ok === false);
+      const successfulClicks = results.filter((result) => result && profileSetupResultAction(result) === "click" && result.ok !== false);
+      const clickCountValues = successfulClicks
+        .map((result) => typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : undefined)
+        .filter((value) => value !== undefined);
       const clickedItems = results
         .filter((result) => result && profileSetupResultAction(result) === "click" && result.ok !== false)
-        .map((result) => ({
-          ordinal: result.ordinal ?? null,
-          selector: result.selector ?? null,
-          frame_selector: result.frame_selector ?? null,
-          text: compactProfileSetupSummaryText(result.text),
-        }));
+        .map((result) => {
+          const clickCount = typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : undefined;
+          return {
+            ordinal: result.ordinal ?? null,
+            selector: result.selector ?? null,
+            frame_selector: result.frame_selector ?? null,
+            text: compactProfileSetupSummaryText(result.text),
+            ...(clickCount ? { click_count: clickCount } : {}),
+          };
+        });
       const clicked = sampleProfileSetupSummaryItems(clickedItems, 8);
       const textSamples = results
         .filter((result) => result && result.ok !== false && typeof result.text === "string" && (
@@ -1918,6 +1947,8 @@ function profileSetupSummary(viewports, actionCount) {
         setup_screenshots: profileSetupScreenshotLabels(results),
         clicked_total: clickedItems.length,
         clicked_truncated: clickedItems.length > clicked.length,
+        click_count_action_total: clickCountValues.length,
+        click_count_value_total: clickCountValues.reduce((sum, value) => sum + value, 0),
         clicked,
         text_samples: textSamples,
         failed: failed.map((result) => ({
@@ -3118,8 +3149,10 @@ async function executeSetupAction(action, ordinal, viewport) {
       const clickOptions = action.force === true
         ? { timeout, noWaitAfter: true, force: true }
         : { timeout, noWaitAfter: true };
+      const clickCount = setupNumber(action.click_count, 1);
+      if (Number.isInteger(clickCount) && clickCount > 1) clickOptions.clickCount = clickCount;
       await locator.nth(targetIndex).click(clickOptions);
-      return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined };
+      return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined, click_count: clickCount > 1 ? clickCount : undefined };
     }
     if (type === "fill" || type === "set_input_value") {
       const scope = await setupActionScope(action, timeout);

package/dist/cli.cjs

@@ -7104,12 +7104,18 @@ function profileSetupSummary(viewports, actionCount) {
     viewports: viewports.map((viewport) => {
       const results = viewport.setup_action_results || [];
       const failed = results.filter((result) => result.ok === false);
-      const clickedItems = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => ({
-        ordinal: result.ordinal ?? null,
-        selector: result.selector ?? null,
-        frame_selector: result.frame_selector ?? null,
-        text: compactProfileSetupSummaryText(result.text)
-      }));
+      const successfulClicks = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false);
+      const clickCountValues = successfulClicks.map((result) => typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : void 0).filter((value) => value !== void 0);
+      const clickedItems = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => {
+        const clickCount = typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : void 0;
+        return {
+          ordinal: result.ordinal ?? null,
+          selector: result.selector ?? null,
+          frame_selector: result.frame_selector ?? null,
+          text: compactProfileSetupSummaryText(result.text),
+          ...clickCount ? { click_count: clickCount } : {}
+        };
+      });
       const clicked = sampleProfileSetupSummaryItems(clickedItems, 8);
       const text_samples = results.filter((result) => result.ok !== false && typeof result.text === "string" && (profileSetupResultAction(result) === "assert_text_visible" || profileSetupResultAction(result) === "assert_text_absent" || profileSetupResultAction(result) === "wait_for_text")).map((result) => ({
         ordinal: result.ordinal ?? null,
@@ -7129,6 +7135,8 @@ function profileSetupSummary(viewports, actionCount) {
         setup_screenshots: profileSetupScreenshotLabels(results),
         clicked_total: clickedItems.length,
         clicked_truncated: clickedItems.length > clicked.length,
+        click_count_action_total: clickCountValues.length,
+        click_count_value_total: clickCountValues.reduce((sum, value) => sum + value, 0),
         clicked,
         text_samples,
         failed: failed.map((result) => ({
@@ -7202,6 +7210,18 @@ function normalizeSetupActionRepeat(input, index) {
   }
   return repeat;
 }
+function normalizeSetupActionClickCount(input, type, index) {
+  const clickCountInput = valueFromOwn(input, "click_count", "clickCount", "clicks");
+  if (clickCountInput === void 0) return void 0;
+  if (type !== "click") {
+    throw new Error(`target.setup_actions[${index}].click_count is only supported for click actions.`);
+  }
+  const clickCount = numberValue(clickCountInput);
+  if (clickCount === void 0 || !Number.isInteger(clickCount) || clickCount < 1 || clickCount > 10) {
+    throw new Error(`target.setup_actions[${index}].click_count must be an integer from 1 to 10.`);
+  }
+  return clickCount;
+}
 function normalizeSetupActionCoordinateMode(value, index) {
   if (value === void 0 || value === null || value === "") return void 0;
   const normalized = String(value).trim().replace(/-/g, "_").toLowerCase();
@@ -7293,6 +7313,7 @@ function normalizeSetupAction(input, index) {
     frame_selector: frameSelector,
     frame_index: frameIndex,
     force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
+    click_count: normalizeSetupActionClickCount(input, type, index),
     coordinate_mode: coordinateMode,
     from_x: fromX,
     from_y: fromY,
@@ -8740,14 +8761,22 @@ function profileSetupSummary(viewports, actionCount) {
     viewports: (viewports || []).map((viewport) => {
       const results = viewport.setup_action_results || [];
       const failed = results.filter((result) => result && result.ok === false);
+      const successfulClicks = results.filter((result) => result && profileSetupResultAction(result) === "click" && result.ok !== false);
+      const clickCountValues = successfulClicks
+        .map((result) => typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : undefined)
+        .filter((value) => value !== undefined);
       const clickedItems = results
         .filter((result) => result && profileSetupResultAction(result) === "click" && result.ok !== false)
-        .map((result) => ({
-          ordinal: result.ordinal ?? null,
-          selector: result.selector ?? null,
-          frame_selector: result.frame_selector ?? null,
-          text: compactProfileSetupSummaryText(result.text),
-        }));
+        .map((result) => {
+          const clickCount = typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : undefined;
+          return {
+            ordinal: result.ordinal ?? null,
+            selector: result.selector ?? null,
+            frame_selector: result.frame_selector ?? null,
+            text: compactProfileSetupSummaryText(result.text),
+            ...(clickCount ? { click_count: clickCount } : {}),
+          };
+        });
       const clicked = sampleProfileSetupSummaryItems(clickedItems, 8);
       const textSamples = results
         .filter((result) => result && result.ok !== false && typeof result.text === "string" && (
@@ -8775,6 +8804,8 @@ function profileSetupSummary(viewports, actionCount) {
         setup_screenshots: profileSetupScreenshotLabels(results),
         clicked_total: clickedItems.length,
         clicked_truncated: clickedItems.length > clicked.length,
+        click_count_action_total: clickCountValues.length,
+        click_count_value_total: clickCountValues.reduce((sum, value) => sum + value, 0),
         clicked,
         text_samples: textSamples,
         failed: failed.map((result) => ({
@@ -9975,8 +10006,10 @@ async function executeSetupAction(action, ordinal, viewport) {
       const clickOptions = action.force === true
         ? { timeout, noWaitAfter: true, force: true }
         : { timeout, noWaitAfter: true };
+      const clickCount = setupNumber(action.click_count, 1);
+      if (Number.isInteger(clickCount) && clickCount > 1) clickOptions.clickCount = clickCount;
       await locator.nth(targetIndex).click(clickOptions);
-      return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined };
+      return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined, click_count: clickCount > 1 ? clickCount : undefined };
     }
     if (type === "fill" || type === "set_input_value") {
       const scope = await setupActionScope(action, timeout);
@@ -11229,20 +11262,26 @@ function profileSetupSummaryMarkdown(result) {
     return sum + labels.filter((label) => typeof label === "string" && label.trim()).length;
   }, 0);
   const clickedTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.clicked_total) || 0), 0);
+  const clickCountActionTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.click_count_action_total) || 0), 0);
+  const clickCountValueTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.click_count_value_total) || 0), 0);
   const failedTotal = viewports.reduce((sum, viewport) => sum + (Array.isArray(viewport.failed) ? viewport.failed.length : 0), 0);
   const lines = [
     `- setup actions: ${declaredActions === void 0 ? "unknown" : declaredActions} declared, ${totalResults} recorded result(s) across ${viewports.length} viewport(s)`,
     `- setup screenshots: ${setupScreenshots}`,
     `- clicked targets: ${clickedTotal}${failedTotal ? `; failed setup actions: ${failedTotal}` : ""}`
   ];
+  if (clickCountActionTotal) {
+    lines.push(`- click counts: ${clickCountActionTotal} action(s), click_count total ${clickCountValueTotal}`);
+  }
   for (const viewport of viewports.slice(0, 8)) {
     const name = cliString(viewport.name) || "viewport";
     const ok = viewport.ok === false ? "failed" : "ok";
     const resultCount = cliFiniteNumber(viewport.result_count) || 0;
     const screenshotCount = Array.isArray(viewport.setup_screenshots) ? viewport.setup_screenshots.filter((label) => typeof label === "string" && label.trim()).length : 0;
     const clicked = cliFiniteNumber(viewport.clicked_total) || 0;
+    const clickCountActions = cliFiniteNumber(viewport.click_count_action_total) || 0;
     const observedPath = cliString(viewport.observed_path);
-    lines.push(`- ${name}: ${ok}, ${resultCount} result(s), ${screenshotCount} setup screenshot(s), ${clicked} click(s)${observedPath ? `, path ${observedPath}` : ""}`);
+    lines.push(`- ${name}: ${ok}, ${resultCount} result(s), ${screenshotCount} setup screenshot(s), ${clicked} click(s)${clickCountActions ? `, ${clickCountActions} click_count action(s)` : ""}${observedPath ? `, path ${observedPath}` : ""}`);
   }
   if (viewports.length > 8) lines.push(`- ${viewports.length - 8} additional viewport(s) omitted from setup summary.`);
   return lines;

package/dist/cli.js

@@ -10,7 +10,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-376FPGFA.js";
+} from "./chunk-KMJBTFLI.js";
 import {
   createRiddleApiClient,
   parseRiddleViewport
@@ -351,20 +351,26 @@ function profileSetupSummaryMarkdown(result) {
     return sum + labels.filter((label) => typeof label === "string" && label.trim()).length;
   }, 0);
   const clickedTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.clicked_total) || 0), 0);
+  const clickCountActionTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.click_count_action_total) || 0), 0);
+  const clickCountValueTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.click_count_value_total) || 0), 0);
   const failedTotal = viewports.reduce((sum, viewport) => sum + (Array.isArray(viewport.failed) ? viewport.failed.length : 0), 0);
   const lines = [
     `- setup actions: ${declaredActions === void 0 ? "unknown" : declaredActions} declared, ${totalResults} recorded result(s) across ${viewports.length} viewport(s)`,
     `- setup screenshots: ${setupScreenshots}`,
     `- clicked targets: ${clickedTotal}${failedTotal ? `; failed setup actions: ${failedTotal}` : ""}`
   ];
+  if (clickCountActionTotal) {
+    lines.push(`- click counts: ${clickCountActionTotal} action(s), click_count total ${clickCountValueTotal}`);
+  }
   for (const viewport of viewports.slice(0, 8)) {
     const name = cliString(viewport.name) || "viewport";
     const ok = viewport.ok === false ? "failed" : "ok";
     const resultCount = cliFiniteNumber(viewport.result_count) || 0;
     const screenshotCount = Array.isArray(viewport.setup_screenshots) ? viewport.setup_screenshots.filter((label) => typeof label === "string" && label.trim()).length : 0;
     const clicked = cliFiniteNumber(viewport.clicked_total) || 0;
+    const clickCountActions = cliFiniteNumber(viewport.click_count_action_total) || 0;
     const observedPath = cliString(viewport.observed_path);
-    lines.push(`- ${name}: ${ok}, ${resultCount} result(s), ${screenshotCount} setup screenshot(s), ${clicked} click(s)${observedPath ? `, path ${observedPath}` : ""}`);
+    lines.push(`- ${name}: ${ok}, ${resultCount} result(s), ${screenshotCount} setup screenshot(s), ${clicked} click(s)${clickCountActions ? `, ${clickCountActions} click_count action(s)` : ""}${observedPath ? `, path ${observedPath}` : ""}`);
   }
   if (viewports.length > 8) lines.push(`- ${viewports.length - 8} additional viewport(s) omitted from setup summary.`);
   return lines;

package/dist/index.cjs

@@ -8945,12 +8945,18 @@ function profileSetupSummary(viewports, actionCount) {
     viewports: viewports.map((viewport) => {
       const results = viewport.setup_action_results || [];
       const failed = results.filter((result) => result.ok === false);
-      const clickedItems = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => ({
-        ordinal: result.ordinal ?? null,
-        selector: result.selector ?? null,
-        frame_selector: result.frame_selector ?? null,
-        text: compactProfileSetupSummaryText(result.text)
-      }));
+      const successfulClicks = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false);
+      const clickCountValues = successfulClicks.map((result) => typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : void 0).filter((value) => value !== void 0);
+      const clickedItems = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => {
+        const clickCount = typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : void 0;
+        return {
+          ordinal: result.ordinal ?? null,
+          selector: result.selector ?? null,
+          frame_selector: result.frame_selector ?? null,
+          text: compactProfileSetupSummaryText(result.text),
+          ...clickCount ? { click_count: clickCount } : {}
+        };
+      });
       const clicked = sampleProfileSetupSummaryItems(clickedItems, 8);
       const text_samples = results.filter((result) => result.ok !== false && typeof result.text === "string" && (profileSetupResultAction(result) === "assert_text_visible" || profileSetupResultAction(result) === "assert_text_absent" || profileSetupResultAction(result) === "wait_for_text")).map((result) => ({
         ordinal: result.ordinal ?? null,
@@ -8970,6 +8976,8 @@ function profileSetupSummary(viewports, actionCount) {
         setup_screenshots: profileSetupScreenshotLabels(results),
         clicked_total: clickedItems.length,
         clicked_truncated: clickedItems.length > clicked.length,
+        click_count_action_total: clickCountValues.length,
+        click_count_value_total: clickCountValues.reduce((sum, value) => sum + value, 0),
         clicked,
         text_samples,
         failed: failed.map((result) => ({
@@ -9043,6 +9051,18 @@ function normalizeSetupActionRepeat(input, index) {
   }
   return repeat;
 }
+function normalizeSetupActionClickCount(input, type, index) {
+  const clickCountInput = valueFromOwn(input, "click_count", "clickCount", "clicks");
+  if (clickCountInput === void 0) return void 0;
+  if (type !== "click") {
+    throw new Error(`target.setup_actions[${index}].click_count is only supported for click actions.`);
+  }
+  const clickCount = numberValue3(clickCountInput);
+  if (clickCount === void 0 || !Number.isInteger(clickCount) || clickCount < 1 || clickCount > 10) {
+    throw new Error(`target.setup_actions[${index}].click_count must be an integer from 1 to 10.`);
+  }
+  return clickCount;
+}
 function normalizeSetupActionCoordinateMode(value, index) {
   if (value === void 0 || value === null || value === "") return void 0;
   const normalized = String(value).trim().replace(/-/g, "_").toLowerCase();
@@ -9134,6 +9154,7 @@ function normalizeSetupAction(input, index) {
     frame_selector: frameSelector,
     frame_index: frameIndex,
     force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
+    click_count: normalizeSetupActionClickCount(input, type, index),
     coordinate_mode: coordinateMode,
     from_x: fromX,
     from_y: fromY,
@@ -10597,14 +10618,22 @@ function profileSetupSummary(viewports, actionCount) {
     viewports: (viewports || []).map((viewport) => {
       const results = viewport.setup_action_results || [];
       const failed = results.filter((result) => result && result.ok === false);
+      const successfulClicks = results.filter((result) => result && profileSetupResultAction(result) === "click" && result.ok !== false);
+      const clickCountValues = successfulClicks
+        .map((result) => typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : undefined)
+        .filter((value) => value !== undefined);
       const clickedItems = results
         .filter((result) => result && profileSetupResultAction(result) === "click" && result.ok !== false)
-        .map((result) => ({
-          ordinal: result.ordinal ?? null,
-          selector: result.selector ?? null,
-          frame_selector: result.frame_selector ?? null,
-          text: compactProfileSetupSummaryText(result.text),
-        }));
+        .map((result) => {
+          const clickCount = typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : undefined;
+          return {
+            ordinal: result.ordinal ?? null,
+            selector: result.selector ?? null,
+            frame_selector: result.frame_selector ?? null,
+            text: compactProfileSetupSummaryText(result.text),
+            ...(clickCount ? { click_count: clickCount } : {}),
+          };
+        });
       const clicked = sampleProfileSetupSummaryItems(clickedItems, 8);
       const textSamples = results
         .filter((result) => result && result.ok !== false && typeof result.text === "string" && (
@@ -10632,6 +10661,8 @@ function profileSetupSummary(viewports, actionCount) {
         setup_screenshots: profileSetupScreenshotLabels(results),
         clicked_total: clickedItems.length,
         clicked_truncated: clickedItems.length > clicked.length,
+        click_count_action_total: clickCountValues.length,
+        click_count_value_total: clickCountValues.reduce((sum, value) => sum + value, 0),
         clicked,
         text_samples: textSamples,
         failed: failed.map((result) => ({
@@ -11832,8 +11863,10 @@ async function executeSetupAction(action, ordinal, viewport) {
       const clickOptions = action.force === true
         ? { timeout, noWaitAfter: true, force: true }
         : { timeout, noWaitAfter: true };
+      const clickCount = setupNumber(action.click_count, 1);
+      if (Number.isInteger(clickCount) && clickCount > 1) clickOptions.clickCount = clickCount;
       await locator.nth(targetIndex).click(clickOptions);
-      return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined };
+      return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined, click_count: clickCount > 1 ? clickCount : undefined };
     }
     if (type === "fill" || type === "set_input_value") {
       const scope = await setupActionScope(action, timeout);

package/dist/index.js

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

package/dist/profile.cjs

@@ -274,12 +274,18 @@ function profileSetupSummary(viewports, actionCount) {
     viewports: viewports.map((viewport) => {
       const results = viewport.setup_action_results || [];
       const failed = results.filter((result) => result.ok === false);
-      const clickedItems = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => ({
-        ordinal: result.ordinal ?? null,
-        selector: result.selector ?? null,
-        frame_selector: result.frame_selector ?? null,
-        text: compactProfileSetupSummaryText(result.text)
-      }));
+      const successfulClicks = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false);
+      const clickCountValues = successfulClicks.map((result) => typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : void 0).filter((value) => value !== void 0);
+      const clickedItems = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => {
+        const clickCount = typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : void 0;
+        return {
+          ordinal: result.ordinal ?? null,
+          selector: result.selector ?? null,
+          frame_selector: result.frame_selector ?? null,
+          text: compactProfileSetupSummaryText(result.text),
+          ...clickCount ? { click_count: clickCount } : {}
+        };
+      });
       const clicked = sampleProfileSetupSummaryItems(clickedItems, 8);
       const text_samples = results.filter((result) => result.ok !== false && typeof result.text === "string" && (profileSetupResultAction(result) === "assert_text_visible" || profileSetupResultAction(result) === "assert_text_absent" || profileSetupResultAction(result) === "wait_for_text")).map((result) => ({
         ordinal: result.ordinal ?? null,
@@ -299,6 +305,8 @@ function profileSetupSummary(viewports, actionCount) {
         setup_screenshots: profileSetupScreenshotLabels(results),
         clicked_total: clickedItems.length,
         clicked_truncated: clickedItems.length > clicked.length,
+        click_count_action_total: clickCountValues.length,
+        click_count_value_total: clickCountValues.reduce((sum, value) => sum + value, 0),
         clicked,
         text_samples,
         failed: failed.map((result) => ({
@@ -372,6 +380,18 @@ function normalizeSetupActionRepeat(input, index) {
   }
   return repeat;
 }
+function normalizeSetupActionClickCount(input, type, index) {
+  const clickCountInput = valueFromOwn(input, "click_count", "clickCount", "clicks");
+  if (clickCountInput === void 0) return void 0;
+  if (type !== "click") {
+    throw new Error(`target.setup_actions[${index}].click_count is only supported for click actions.`);
+  }
+  const clickCount = numberValue(clickCountInput);
+  if (clickCount === void 0 || !Number.isInteger(clickCount) || clickCount < 1 || clickCount > 10) {
+    throw new Error(`target.setup_actions[${index}].click_count must be an integer from 1 to 10.`);
+  }
+  return clickCount;
+}
 function normalizeSetupActionCoordinateMode(value, index) {
   if (value === void 0 || value === null || value === "") return void 0;
   const normalized = String(value).trim().replace(/-/g, "_").toLowerCase();
@@ -463,6 +483,7 @@ function normalizeSetupAction(input, index) {
     frame_selector: frameSelector,
     frame_index: frameIndex,
     force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
+    click_count: normalizeSetupActionClickCount(input, type, index),
     coordinate_mode: coordinateMode,
     from_x: fromX,
     from_y: fromY,
@@ -1926,14 +1947,22 @@ function profileSetupSummary(viewports, actionCount) {
     viewports: (viewports || []).map((viewport) => {
       const results = viewport.setup_action_results || [];
       const failed = results.filter((result) => result && result.ok === false);
+      const successfulClicks = results.filter((result) => result && profileSetupResultAction(result) === "click" && result.ok !== false);
+      const clickCountValues = successfulClicks
+        .map((result) => typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : undefined)
+        .filter((value) => value !== undefined);
       const clickedItems = results
         .filter((result) => result && profileSetupResultAction(result) === "click" && result.ok !== false)
-        .map((result) => ({
-          ordinal: result.ordinal ?? null,
-          selector: result.selector ?? null,
-          frame_selector: result.frame_selector ?? null,
-          text: compactProfileSetupSummaryText(result.text),
-        }));
+        .map((result) => {
+          const clickCount = typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : undefined;
+          return {
+            ordinal: result.ordinal ?? null,
+            selector: result.selector ?? null,
+            frame_selector: result.frame_selector ?? null,
+            text: compactProfileSetupSummaryText(result.text),
+            ...(clickCount ? { click_count: clickCount } : {}),
+          };
+        });
       const clicked = sampleProfileSetupSummaryItems(clickedItems, 8);
       const textSamples = results
         .filter((result) => result && result.ok !== false && typeof result.text === "string" && (
@@ -1961,6 +1990,8 @@ function profileSetupSummary(viewports, actionCount) {
         setup_screenshots: profileSetupScreenshotLabels(results),
         clicked_total: clickedItems.length,
         clicked_truncated: clickedItems.length > clicked.length,
+        click_count_action_total: clickCountValues.length,
+        click_count_value_total: clickCountValues.reduce((sum, value) => sum + value, 0),
         clicked,
         text_samples: textSamples,
         failed: failed.map((result) => ({
@@ -3161,8 +3192,10 @@ async function executeSetupAction(action, ordinal, viewport) {
       const clickOptions = action.force === true
         ? { timeout, noWaitAfter: true, force: true }
         : { timeout, noWaitAfter: true };
+      const clickCount = setupNumber(action.click_count, 1);
+      if (Number.isInteger(clickCount) && clickCount > 1) clickOptions.clickCount = clickCount;
       await locator.nth(targetIndex).click(clickOptions);
-      return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined };
+      return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined, click_count: clickCount > 1 ? clickCount : undefined };
     }
     if (type === "fill" || type === "set_input_value") {
       const scope = await setupActionScope(action, timeout);

package/dist/profile.d.cts

@@ -23,6 +23,7 @@ interface RiddleProofProfileSetupAction {
     frame_selector?: string;
     frame_index?: number;
     force?: boolean;
+    click_count?: number;
     coordinate_mode?: "pixels" | "ratio";
     from_x?: number;
     from_y?: number;

package/dist/profile.d.ts

@@ -23,6 +23,7 @@ interface RiddleProofProfileSetupAction {
     frame_selector?: string;
     frame_index?: number;
     force?: boolean;
+    click_count?: number;
     coordinate_mode?: "pixels" | "ratio";
     from_x?: number;
     from_y?: number;

package/dist/profile.js

@@ -19,7 +19,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-376FPGFA.js";
+} from "./chunk-KMJBTFLI.js";
 export {
   RIDDLE_PROOF_PROFILE_CHECK_TYPES,
   RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,

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

@@ -292,7 +292,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     blocking?: boolean;
     details?: Record<string, unknown>;
     ok: boolean;
-    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
     state_path: string;
     stage: any;
     summary: string;
@@ -382,7 +382,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     continueWithStage?: WorkflowStage | null;
     blocking?: boolean;
     details?: Record<string, unknown>;
-    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
     state_path: string;
     stage: any;
     checkpoint: string;
@@ -659,7 +659,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     error?: undefined;
 } | {
     ok: boolean;
-    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
     state_path: string;
     stage: any;
     summary: string;

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

@@ -292,7 +292,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     blocking?: boolean;
     details?: Record<string, unknown>;
     ok: boolean;
-    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
     state_path: string;
     stage: any;
     summary: string;
@@ -382,7 +382,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     continueWithStage?: WorkflowStage | null;
     blocking?: boolean;
     details?: Record<string, unknown>;
-    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
     state_path: string;
     stage: any;
     checkpoint: string;
@@ -659,7 +659,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     error?: undefined;
 } | {
     ok: boolean;
-    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
     state_path: string;
     stage: any;
     summary: string;

package/package.json

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