@riddledc/riddle-proof 0.7.60 → 0.7.62

package/dist/profile.cjs

@@ -77,6 +77,7 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
 ];
 var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "click",
+  "drag",
   "press",
   "fill",
   "set_input_value",
@@ -217,6 +218,78 @@ function toJsonValue(value) {
   if (isRecord(value)) return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, toJsonValue(child)]));
   return String(value);
 }
+function compactProfileSetupSummaryText(value, limit = 160) {
+  const text = typeof value === "string" ? value.replace(/\s+/g, " ").trim() : "";
+  if (!text) return void 0;
+  if (text.length <= limit) return text;
+  return `${text.slice(0, Math.max(0, limit - 15)).trimEnd()}... (${text.length} chars)`;
+}
+function profileSetupResultAction(value) {
+  const action = value.action ?? value.type;
+  return typeof action === "string" && action ? action : "unknown";
+}
+function profileSetupFrameUrls(viewport) {
+  const urls = [];
+  const frames = viewport.frames || {};
+  for (const container of Object.values(frames)) {
+    if (!isRecord(container) || !Array.isArray(container.frames)) continue;
+    for (const frame of container.frames) {
+      if (!isRecord(frame)) continue;
+      const url = typeof frame.url === "string" ? frame.url : void 0;
+      if (url && !urls.includes(url)) urls.push(url);
+    }
+  }
+  return urls.slice(0, 10);
+}
+function profileSetupActionCounts(results) {
+  const counts = {};
+  for (const result of results) {
+    const action = profileSetupResultAction(result);
+    counts[action] = (counts[action] || 0) + 1;
+  }
+  return toJsonValue(counts);
+}
+function profileSetupSummary(viewports, actionCount) {
+  return toJsonValue({
+    viewport_count: viewports.length,
+    action_count: actionCount ?? null,
+    viewports: viewports.map((viewport) => {
+      const results = viewport.setup_action_results || [];
+      const failed = results.filter((result) => result.ok === false);
+      const clicked = 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)
+      })).slice(0, 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,
+        action: profileSetupResultAction(result),
+        frame_selector: result.frame_selector ?? null,
+        text: compactProfileSetupSummaryText(result.text)
+      })).filter((item) => item.text).slice(-6);
+      return {
+        name: viewport.name,
+        ok: (actionCount === void 0 ? results.length > 0 : results.length >= actionCount) && failed.length === 0,
+        result_count: results.length,
+        observed_path: viewport.route?.observed ?? null,
+        final_url: viewport.url ?? null,
+        action_counts: profileSetupActionCounts(results),
+        frame_action_count: results.filter((result) => result.frame_selector).length,
+        frame_urls: profileSetupFrameUrls(viewport),
+        clicked,
+        text_samples,
+        failed: failed.map((result) => ({
+          ordinal: result.ordinal ?? null,
+          action: profileSetupResultAction(result),
+          selector: result.selector ?? null,
+          frame_selector: result.frame_selector ?? null,
+          reason: result.reason ?? result.error ?? null
+        }))
+      };
+    })
+  });
+}
 function normalizeName(value, fallback) {
   const name = stringValue(value) || fallback;
   return name.replace(/\s+/g, " ").trim();
@@ -247,7 +320,7 @@ function isSupportedCheckType(value) {
 }
 function normalizeSetupActionType(value, index) {
   const normalizedInput = String(value || "").trim().replace(/-/g, "_");
-  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput;
+  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput;
   if (RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.includes(normalized)) {
     return normalized;
   }
@@ -277,6 +350,13 @@ function normalizeSetupActionRepeat(input, index) {
   }
   return repeat;
 }
+function normalizeSetupActionCoordinateMode(value, index) {
+  if (value === void 0 || value === null || value === "") return void 0;
+  const normalized = String(value).trim().replace(/-/g, "_").toLowerCase();
+  if (normalized === "pixels" || normalized === "pixel" || normalized === "px") return "pixels";
+  if (normalized === "ratio" || normalized === "relative" || normalized === "fraction") return "ratio";
+  throw new Error(`target.setup_actions[${index}].coordinate_mode ${String(value)} is not supported. Supported coordinate modes: pixels, ratio.`);
+}
 function normalizeSetupAction(input, index) {
   if (!isRecord(input)) throw new Error(`target.setup_actions[${index}] must be an object.`);
   const type = normalizeSetupActionType(stringValue(input.type), index);
@@ -286,9 +366,25 @@ function normalizeSetupAction(input, index) {
   if (frameIndex !== void 0 && (!Number.isInteger(frameIndex) || frameIndex < 0)) {
     throw new Error(`target.setup_actions[${index}].frame_index must be a non-negative integer.`);
   }
-  if ((type === "click" || type === "fill" || type === "set_input_value" || type === "wait_for_selector" || type === "wait_for_text" || type === "assert_text_visible" || type === "assert_text_absent" || type === "assert_selector_count") && !selector) {
+  if ((type === "click" || type === "drag" || type === "fill" || type === "set_input_value" || type === "wait_for_selector" || type === "wait_for_text" || type === "assert_text_visible" || type === "assert_text_absent" || type === "assert_selector_count") && !selector) {
     throw new Error(`target.setup_actions[${index}] ${type} requires selector.`);
   }
+  const fromX = numberValue(valueFromOwn(input, "from_x", "fromX", "start_x", "startX", "x1"));
+  const fromY = numberValue(valueFromOwn(input, "from_y", "fromY", "start_y", "startY", "y1"));
+  const toX = numberValue(valueFromOwn(input, "to_x", "toX", "end_x", "endX", "x2"));
+  const toY = numberValue(valueFromOwn(input, "to_y", "toY", "end_y", "endY", "y2"));
+  const coordinateMode = normalizeSetupActionCoordinateMode(valueFromOwn(input, "coordinate_mode", "coordinateMode", "coords", "units"), index);
+  if (type === "drag") {
+    if (fromX === void 0 || fromY === void 0 || toX === void 0 || toY === void 0) {
+      throw new Error(`target.setup_actions[${index}] drag requires from_x, from_y, to_x, and to_y.`);
+    }
+    if (coordinateMode === "ratio" && [fromX, fromY, toX, toY].some((value2) => value2 < 0 || value2 > 1)) {
+      throw new Error(`target.setup_actions[${index}] drag ratio coordinates must be between 0 and 1.`);
+    }
+    if ((coordinateMode === void 0 || coordinateMode === "pixels") && [fromX, fromY, toX, toY].some((value2) => value2 < 0)) {
+      throw new Error(`target.setup_actions[${index}] drag pixel coordinates must be non-negative.`);
+    }
+  }
   if (type === "wait_for_text" && !stringValue(input.text) && !stringValue(input.pattern)) {
     throw new Error(`target.setup_actions[${index}] wait_for_text requires text or pattern.`);
   }
@@ -335,12 +431,23 @@ function normalizeSetupAction(input, index) {
     }
   }
   const hasExpectedReturn = hasOwn(input, "expect_return") || hasOwn(input, "expectReturn") || hasOwn(input, "expected_return") || hasOwn(input, "expectedReturn");
+  const steps = numberValue(input.steps);
+  if (type === "drag" && steps !== void 0 && (!Number.isInteger(steps) || steps < 1 || steps > 100)) {
+    throw new Error(`target.setup_actions[${index}].steps must be an integer from 1 to 100.`);
+  }
   return {
     type,
     selector,
     frame_selector: frameSelector,
     frame_index: frameIndex,
     force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
+    coordinate_mode: coordinateMode,
+    from_x: fromX,
+    from_y: fromY,
+    to_x: toX,
+    to_y: toY,
+    duration_ms: numberValue(input.duration_ms) ?? numberValue(input.durationMs),
+    steps,
     key,
     value,
     value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
@@ -1289,6 +1396,7 @@ function assessSetupActionsFromEvidence(profile, evidence) {
         ok: (viewport.setup_action_results || []).length >= actionCount && (viewport.setup_action_results || []).every((result) => result.ok !== false),
         result_count: (viewport.setup_action_results || []).length
       })),
+      setup_summary: profileSetupSummary(viewports, actionCount),
       failed
     },
     message: failed.length ? `Setup actions failed in ${failed.length} viewport action(s).` : void 0
@@ -1702,6 +1810,90 @@ function requiredNetworkMockHitCount(mock) {
   if (Array.isArray(mock.responses) && mock.responses.length) return mock.responses.length;
   return 1;
 }
+function compactProfileSetupSummaryText(value, limit) {
+  limit = limit || 160;
+  const text = typeof value === "string" ? value.replace(/\\s+/g, " ").trim() : "";
+  if (!text) return undefined;
+  if (text.length <= limit) return text;
+  return text.slice(0, Math.max(0, limit - 15)).trimEnd() + "... (" + text.length + " chars)";
+}
+function profileSetupResultAction(result) {
+  const action = result && (result.action || result.type);
+  return typeof action === "string" && action ? action : "unknown";
+}
+function profileSetupFrameUrls(viewport) {
+  const urls = [];
+  const frames = viewport && viewport.frames || {};
+  for (const container of Object.values(frames)) {
+    if (!container || typeof container !== "object" || Array.isArray(container) || !Array.isArray(container.frames)) continue;
+    for (const frame of container.frames) {
+      if (!frame || typeof frame !== "object" || Array.isArray(frame)) continue;
+      const url = typeof frame.url === "string" ? frame.url : null;
+      if (url && !urls.includes(url)) urls.push(url);
+    }
+  }
+  return urls.slice(0, 10);
+}
+function profileSetupActionCounts(results) {
+  const counts = {};
+  for (const result of results || []) {
+    const action = profileSetupResultAction(result);
+    counts[action] = (counts[action] || 0) + 1;
+  }
+  return counts;
+}
+function profileSetupSummary(viewports, actionCount) {
+  return {
+    viewport_count: (viewports || []).length,
+    action_count: actionCount ?? null,
+    viewports: (viewports || []).map((viewport) => {
+      const results = viewport.setup_action_results || [];
+      const failed = results.filter((result) => result && result.ok === false);
+      const clicked = 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),
+        }))
+        .slice(0, 8);
+      const textSamples = results
+        .filter((result) => 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,
+          action: profileSetupResultAction(result),
+          frame_selector: result.frame_selector ?? null,
+          text: compactProfileSetupSummaryText(result.text),
+        }))
+        .filter((item) => item.text)
+        .slice(-6);
+      return {
+        name: viewport.name,
+        ok: (actionCount === undefined ? results.length > 0 : results.length >= actionCount) && failed.length === 0,
+        result_count: results.length,
+        observed_path: viewport.route && viewport.route.observed || null,
+        final_url: viewport.url || null,
+        action_counts: profileSetupActionCounts(results),
+        frame_action_count: results.filter((result) => result && result.frame_selector).length,
+        frame_urls: profileSetupFrameUrls(viewport),
+        clicked,
+        text_samples: textSamples,
+        failed: failed.map((result) => ({
+          ordinal: result.ordinal ?? null,
+          action: profileSetupResultAction(result),
+          selector: result.selector ?? null,
+          frame_selector: result.frame_selector ?? null,
+          reason: result.reason || result.error || null,
+        })),
+      };
+    }),
+  };
+}
 function assessProfile(profile, evidence) {
   const checks = [];
   const viewports = evidence.viewports || [];
@@ -1806,6 +1998,7 @@ function assessProfile(profile, evidence) {
             && (viewport.setup_action_results || []).every((result) => !result || result.ok !== false),
           result_count: (viewport.setup_action_results || []).length,
         })),
+        setup_summary: profileSetupSummary(viewports, actionCount),
         failed,
       },
       message: failed.length ? "Setup actions failed in " + failed.length + " viewport action(s)." : undefined,
@@ -2548,6 +2741,71 @@ async function executeSetupAction(action, ordinal) {
       await scope.context.waitForSelector(action.selector, { state: "visible", timeout });
       return { ...base, ...setupScopeEvidence(scope), ok: true, timeout_ms: timeout };
     }
+    if (type === "drag") {
+      const scope = await setupActionScope(action, timeout);
+      if (!scope.ok) return setupScopeFailure(base, scope);
+      const locator = scope.context.locator(action.selector);
+      const count = await locator.count();
+      if (!count) return { ...base, ...setupScopeEvidence(scope), reason: "selector_not_found", count };
+      const targetIndex = Number.isInteger(action.index) ? action.index : 0;
+      if (targetIndex < 0 || targetIndex >= count) return { ...base, ...setupScopeEvidence(scope), reason: "index_out_of_range", count, target_index: targetIndex };
+      const target = locator.nth(targetIndex);
+      await target.waitFor({ state: "visible", timeout });
+      const box = await target.boundingBox();
+      if (!box) return { ...base, ...setupScopeEvidence(scope), reason: "bounding_box_unavailable", count, target_index: targetIndex };
+      const mode = String(action.coordinate_mode || action.coordinateMode || "pixels").trim();
+      const coordinate = (value, size) => mode === "ratio" ? value * size : value;
+      const fromX = setupFiniteNumber(action.from_x ?? action.fromX ?? action.start_x ?? action.startX ?? action.x1);
+      const fromY = setupFiniteNumber(action.from_y ?? action.fromY ?? action.start_y ?? action.startY ?? action.y1);
+      const toX = setupFiniteNumber(action.to_x ?? action.toX ?? action.end_x ?? action.endX ?? action.x2);
+      const toY = setupFiniteNumber(action.to_y ?? action.toY ?? action.end_y ?? action.endY ?? action.y2);
+      if (fromX === undefined || fromY === undefined || toX === undefined || toY === undefined) return { ...base, ...setupScopeEvidence(scope), reason: "missing_drag_coordinates", count, target_index: targetIndex };
+      if (mode === "ratio" && [fromX, fromY, toX, toY].some((value) => value < 0 || value > 1)) return { ...base, ...setupScopeEvidence(scope), reason: "invalid_ratio_coordinates", count, target_index: targetIndex };
+      if (mode !== "ratio" && [fromX, fromY, toX, toY].some((value) => value < 0)) return { ...base, ...setupScopeEvidence(scope), reason: "invalid_pixel_coordinates", count, target_index: targetIndex };
+      const start = {
+        x: box.x + coordinate(fromX, box.width),
+        y: box.y + coordinate(fromY, box.height),
+      };
+      const end = {
+        x: box.x + coordinate(toX, box.width),
+        y: box.y + coordinate(toY, box.height),
+      };
+      const requestedSteps = setupNumber(action.steps, 8);
+      const steps = Math.min(100, Math.max(1, Math.floor(requestedSteps || 8)));
+      const durationMs = setupNumber(action.duration_ms ?? action.durationMs, 0);
+      await page.mouse.move(start.x, start.y);
+      await page.mouse.down();
+      try {
+        if (durationMs && steps > 1) {
+          for (let step = 1; step <= steps; step += 1) {
+            const progress = step / steps;
+            await page.mouse.move(
+              start.x + (end.x - start.x) * progress,
+              start.y + (end.y - start.y) * progress,
+            );
+            await page.waitForTimeout(durationMs / steps);
+          }
+        } else {
+          await page.mouse.move(end.x, end.y, { steps });
+        }
+      } finally {
+        await page.mouse.up().catch(() => {});
+      }
+      return {
+        ...base,
+        ...setupScopeEvidence(scope),
+        ok: true,
+        count,
+        target_index: targetIndex,
+        coordinate_mode: mode,
+        from_x: fromX,
+        from_y: fromY,
+        to_x: toX,
+        to_y: toY,
+        steps,
+        duration_ms: durationMs || undefined,
+      };
+    }
     if (type === "press") {
       const key = String(action.key || "").trim();
       if (!key) return { ...base, reason: "missing_key" };

package/dist/profile.d.cts

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

package/dist/profile.d.ts

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

package/dist/profile.js

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

package/package.json

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