@riddledc/riddle-proof 0.7.195 → 0.7.196

package/dist/{chunk-UKMTTGQ4.js → chunk-WUOU5RB4.js}

@@ -1255,6 +1255,7 @@ function normalizeSetupAction(input, index) {
     frame_index: frameIndex,
     full_page: normalizeSetupActionScreenshotFullPage(input, type, index),
     force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
+    fallback_to_tap: type === "click" && (input.fallback_to_tap === true || input.fallbackToTap === true || input.fallback_to_pointer_tap === true || input.fallbackToPointerTap === true || input.pointer_fallback === true || input.pointerFallback === true) || void 0,
     click_count: normalizeSetupActionClickCount(input, type, index),
     coordinate_mode: coordinateMode,
     pointer_type: pointerType,
@@ -7127,6 +7128,7 @@ 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 target = locator.nth(targetIndex);
       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;
@@ -7134,7 +7136,6 @@ async function executeSetupAction(action, ordinal, viewport) {
       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();
@@ -7142,7 +7143,43 @@ async function executeSetupAction(action, ordinal, viewport) {
         position = { x: coordinate(fromX, box.width), y: coordinate(fromY, box.height) };
         clickOptions.position = position;
       }
-      await locator.nth(targetIndex).click(clickOptions);
+      try {
+        await target.click(clickOptions);
+      } catch (error) {
+        if (action.fallback_to_tap !== true) throw error;
+        const box = await target.boundingBox();
+        if (!box) {
+          return {
+            ...base,
+            ...setupScopeEvidence(scope),
+            reason: "fallback_bounding_box_unavailable",
+            count,
+            target_index: targetIndex,
+            click_error: String(error && error.message ? error.message : error).slice(0, 1000),
+          };
+        }
+        const fallbackPoint = position
+          ? { x: box.x + position.x, y: box.y + position.y }
+          : { x: box.x + box.width / 2, y: box.y + box.height / 2 };
+        if (clickCount > 1) await page.mouse.click(fallbackPoint.x, fallbackPoint.y, { clickCount });
+        else await page.mouse.click(fallbackPoint.x, fallbackPoint.y);
+        return {
+          ...base,
+          ...setupScopeEvidence(scope),
+          ok: true,
+          count,
+          target_index: targetIndex,
+          text: matchedText,
+          force: action.force === true || undefined,
+          fallback_to_tap: true,
+          input_dispatch: "playwright_mouse",
+          click_error: String(error && error.message ? error.message : error).slice(0, 1000),
+          click_count: clickCount > 1 ? clickCount : undefined,
+          coordinate_mode: mode,
+          x: position ? fromX : undefined,
+          y: position ? fromY : undefined,
+        };
+      }
       return {
         ...base,
         ...setupScopeEvidence(scope),

package/dist/cli.cjs

@@ -8212,6 +8212,7 @@ function normalizeSetupAction(input, index) {
     frame_index: frameIndex,
     full_page: normalizeSetupActionScreenshotFullPage(input, type, index),
     force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
+    fallback_to_tap: type === "click" && (input.fallback_to_tap === true || input.fallbackToTap === true || input.fallback_to_pointer_tap === true || input.fallbackToPointerTap === true || input.pointer_fallback === true || input.pointerFallback === true) || void 0,
     click_count: normalizeSetupActionClickCount(input, type, index),
     coordinate_mode: coordinateMode,
     pointer_type: pointerType,
@@ -14068,6 +14069,7 @@ 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 target = locator.nth(targetIndex);
       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;
@@ -14075,7 +14077,6 @@ async function executeSetupAction(action, ordinal, viewport) {
       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();
@@ -14083,7 +14084,43 @@ async function executeSetupAction(action, ordinal, viewport) {
         position = { x: coordinate(fromX, box.width), y: coordinate(fromY, box.height) };
         clickOptions.position = position;
       }
-      await locator.nth(targetIndex).click(clickOptions);
+      try {
+        await target.click(clickOptions);
+      } catch (error) {
+        if (action.fallback_to_tap !== true) throw error;
+        const box = await target.boundingBox();
+        if (!box) {
+          return {
+            ...base,
+            ...setupScopeEvidence(scope),
+            reason: "fallback_bounding_box_unavailable",
+            count,
+            target_index: targetIndex,
+            click_error: String(error && error.message ? error.message : error).slice(0, 1000),
+          };
+        }
+        const fallbackPoint = position
+          ? { x: box.x + position.x, y: box.y + position.y }
+          : { x: box.x + box.width / 2, y: box.y + box.height / 2 };
+        if (clickCount > 1) await page.mouse.click(fallbackPoint.x, fallbackPoint.y, { clickCount });
+        else await page.mouse.click(fallbackPoint.x, fallbackPoint.y);
+        return {
+          ...base,
+          ...setupScopeEvidence(scope),
+          ok: true,
+          count,
+          target_index: targetIndex,
+          text: matchedText,
+          force: action.force === true || undefined,
+          fallback_to_tap: true,
+          input_dispatch: "playwright_mouse",
+          click_error: String(error && error.message ? error.message : error).slice(0, 1000),
+          click_count: clickCount > 1 ? clickCount : undefined,
+          coordinate_mode: mode,
+          x: position ? fromX : undefined,
+          y: position ? fromY : undefined,
+        };
+      }
       return {
         ...base,
         ...setupScopeEvidence(scope),

package/dist/cli.js

@@ -13,7 +13,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-UKMTTGQ4.js";
+} from "./chunk-WUOU5RB4.js";
 import {
   createRiddleApiClient,
   isTerminalRiddleJobStatus,

package/dist/index.cjs

@@ -9988,6 +9988,7 @@ function normalizeSetupAction(input, index) {
     frame_index: frameIndex,
     full_page: normalizeSetupActionScreenshotFullPage(input, type, index),
     force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
+    fallback_to_tap: type === "click" && (input.fallback_to_tap === true || input.fallbackToTap === true || input.fallback_to_pointer_tap === true || input.fallbackToPointerTap === true || input.pointer_fallback === true || input.pointerFallback === true) || void 0,
     click_count: normalizeSetupActionClickCount(input, type, index),
     coordinate_mode: coordinateMode,
     pointer_type: pointerType,
@@ -15860,6 +15861,7 @@ 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 target = locator.nth(targetIndex);
       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;
@@ -15867,7 +15869,6 @@ async function executeSetupAction(action, ordinal, viewport) {
       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();
@@ -15875,7 +15876,43 @@ async function executeSetupAction(action, ordinal, viewport) {
         position = { x: coordinate(fromX, box.width), y: coordinate(fromY, box.height) };
         clickOptions.position = position;
       }
-      await locator.nth(targetIndex).click(clickOptions);
+      try {
+        await target.click(clickOptions);
+      } catch (error) {
+        if (action.fallback_to_tap !== true) throw error;
+        const box = await target.boundingBox();
+        if (!box) {
+          return {
+            ...base,
+            ...setupScopeEvidence(scope),
+            reason: "fallback_bounding_box_unavailable",
+            count,
+            target_index: targetIndex,
+            click_error: String(error && error.message ? error.message : error).slice(0, 1000),
+          };
+        }
+        const fallbackPoint = position
+          ? { x: box.x + position.x, y: box.y + position.y }
+          : { x: box.x + box.width / 2, y: box.y + box.height / 2 };
+        if (clickCount > 1) await page.mouse.click(fallbackPoint.x, fallbackPoint.y, { clickCount });
+        else await page.mouse.click(fallbackPoint.x, fallbackPoint.y);
+        return {
+          ...base,
+          ...setupScopeEvidence(scope),
+          ok: true,
+          count,
+          target_index: targetIndex,
+          text: matchedText,
+          force: action.force === true || undefined,
+          fallback_to_tap: true,
+          input_dispatch: "playwright_mouse",
+          click_error: String(error && error.message ? error.message : error).slice(0, 1000),
+          click_count: clickCount > 1 ? clickCount : undefined,
+          coordinate_mode: mode,
+          x: position ? fromX : undefined,
+          y: position ? fromY : undefined,
+        };
+      }
       return {
         ...base,
         ...setupScopeEvidence(scope),

package/dist/index.js

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

package/dist/profile.cjs

@@ -1302,6 +1302,7 @@ function normalizeSetupAction(input, index) {
     frame_index: frameIndex,
     full_page: normalizeSetupActionScreenshotFullPage(input, type, index),
     force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
+    fallback_to_tap: type === "click" && (input.fallback_to_tap === true || input.fallbackToTap === true || input.fallback_to_pointer_tap === true || input.fallbackToPointerTap === true || input.pointer_fallback === true || input.pointerFallback === true) || void 0,
     click_count: normalizeSetupActionClickCount(input, type, index),
     coordinate_mode: coordinateMode,
     pointer_type: pointerType,
@@ -7174,6 +7175,7 @@ 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 target = locator.nth(targetIndex);
       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;
@@ -7181,7 +7183,6 @@ async function executeSetupAction(action, ordinal, viewport) {
       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();
@@ -7189,7 +7190,43 @@ async function executeSetupAction(action, ordinal, viewport) {
         position = { x: coordinate(fromX, box.width), y: coordinate(fromY, box.height) };
         clickOptions.position = position;
       }
-      await locator.nth(targetIndex).click(clickOptions);
+      try {
+        await target.click(clickOptions);
+      } catch (error) {
+        if (action.fallback_to_tap !== true) throw error;
+        const box = await target.boundingBox();
+        if (!box) {
+          return {
+            ...base,
+            ...setupScopeEvidence(scope),
+            reason: "fallback_bounding_box_unavailable",
+            count,
+            target_index: targetIndex,
+            click_error: String(error && error.message ? error.message : error).slice(0, 1000),
+          };
+        }
+        const fallbackPoint = position
+          ? { x: box.x + position.x, y: box.y + position.y }
+          : { x: box.x + box.width / 2, y: box.y + box.height / 2 };
+        if (clickCount > 1) await page.mouse.click(fallbackPoint.x, fallbackPoint.y, { clickCount });
+        else await page.mouse.click(fallbackPoint.x, fallbackPoint.y);
+        return {
+          ...base,
+          ...setupScopeEvidence(scope),
+          ok: true,
+          count,
+          target_index: targetIndex,
+          text: matchedText,
+          force: action.force === true || undefined,
+          fallback_to_tap: true,
+          input_dispatch: "playwright_mouse",
+          click_error: String(error && error.message ? error.message : error).slice(0, 1000),
+          click_count: clickCount > 1 ? clickCount : undefined,
+          coordinate_mode: mode,
+          x: position ? fromX : undefined,
+          y: position ? fromY : undefined,
+        };
+      }
       return {
         ...base,
         ...setupScopeEvidence(scope),

package/dist/profile.d.cts

@@ -114,6 +114,7 @@ interface RiddleProofProfileSetupAction {
     frame_index?: number;
     full_page?: boolean;
     force?: boolean;
+    fallback_to_tap?: boolean;
     click_count?: number;
     coordinate_mode?: "pixels" | "ratio";
     pointer_type?: "mouse" | "touch" | "pen";

package/dist/profile.d.ts

@@ -114,6 +114,7 @@ interface RiddleProofProfileSetupAction {
     frame_index?: number;
     full_page?: boolean;
     force?: boolean;
+    fallback_to_tap?: boolean;
     click_count?: number;
     coordinate_mode?: "pixels" | "ratio";
     pointer_type?: "mouse" | "touch" | "pen";

package/dist/profile.js

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