@riddledc/riddle-proof 0.7.129 → 0.7.131

package/dist/profile.cjs

@@ -654,6 +654,17 @@ function normalizeSetupActionCoordinateMode(value, index) {
   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 normalizeSetupActionPointerType(value, type, index) {
+  if (value === void 0 || value === null || value === "") return void 0;
+  if (type !== "drag") {
+    throw new Error(`target.setup_actions[${index}].pointer_type is only supported for drag actions.`);
+  }
+  const normalized = String(value).trim().replace(/-/g, "_").toLowerCase();
+  if (normalized === "mouse") return "mouse";
+  if (normalized === "touch" || normalized === "finger") return "touch";
+  if (normalized === "pen" || normalized === "stylus") return "pen";
+  throw new Error(`target.setup_actions[${index}].pointer_type ${String(value)} is not supported. Supported pointer types: mouse, touch, pen.`);
+}
 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);
@@ -672,6 +683,7 @@ function normalizeSetupAction(input, index) {
   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 === "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.`);
@@ -756,6 +768,7 @@ function normalizeSetupAction(input, index) {
     force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
     click_count: normalizeSetupActionClickCount(input, type, index),
     coordinate_mode: coordinateMode,
+    pointer_type: pointerType,
     from_x: fromX,
     from_y: fromY,
     to_x: toX,
@@ -1934,6 +1947,27 @@ function textMatchSamples(sample, check) {
   const sampleText = textSampleAroundMatch(source, index, text.length);
   return sampleText ? [sampleText] : [];
 }
+function textCaseInsensitiveSamples(sample, check) {
+  const source = String(sample || "");
+  const text = check.pattern ? "" : check.text || "";
+  if (!source || !text) return [];
+  const index = source.toLowerCase().indexOf(text.toLowerCase());
+  const sampleText = textSampleAroundMatch(source, index, text.length);
+  return sampleText ? [sampleText] : [];
+}
+function textCaseInsensitiveSequenceSamples(texts, check) {
+  const text = check.pattern ? "" : compactTextEvidenceSample(check.text || "");
+  if (!text) return [];
+  const expected = text.toLowerCase();
+  return texts.map((candidate) => compactTextEvidenceSample(candidate)).filter((candidate) => candidate && candidate.toLowerCase().includes(expected)).slice(0, 3).map((candidate) => candidate.slice(0, 240));
+}
+function textCaseInsensitiveFailureSamples(viewport, check) {
+  const key = textKey(check);
+  const captured = viewport.text_case_insensitive_samples?.[key] || [];
+  const capturedSamples = captured.map((sample) => compactTextEvidenceSample(sample).slice(0, 240)).filter(Boolean);
+  if (capturedSamples.length) return capturedSamples.slice(0, 3);
+  return textCaseInsensitiveSamples(viewport.body_text_sample || "", check).slice(0, 3);
+}
 function textCheckFailureSamples(viewport, check) {
   const key = textKey(check);
   const captured = viewport.text_match_samples?.[key] || [];
@@ -2246,13 +2280,15 @@ function assessCheckFromEvidence(check, evidence) {
       const matched = matches.length > 0;
       const failedAgainstExpectation = matched !== expectedVisible;
       const sampleTexts = matches.length ? matches : failedAgainstExpectation ? texts : [];
+      const caseInsensitiveSamples = failedAgainstExpectation && expectedVisible && !matched ? textCaseInsensitiveSequenceSamples(texts, check) : [];
       return {
         viewport: viewport.name,
         selector_count: viewport.selectors?.[key]?.count || 0,
         visible_count: viewport.selectors?.[key]?.visible_count || 0,
         matched_count: matches.length,
         matched,
-        samples: sampleTexts.slice(0, 3).map((text) => text.slice(0, 240))
+        samples: sampleTexts.slice(0, 3).map((text) => text.slice(0, 240)),
+        case_insensitive_samples: caseInsensitiveSamples
       };
     });
     const failed = results.filter((result) => result.matched !== expectedVisible).length;
@@ -2395,7 +2431,8 @@ function assessCheckFromEvidence(check, evidence) {
       return {
         viewport: viewport.name,
         matched,
-        samples: failedAgainstExpectation ? textCheckFailureSamples(viewport, check) : []
+        samples: failedAgainstExpectation ? textCheckFailureSamples(viewport, check) : [],
+        case_insensitive_samples: failedAgainstExpectation && expectedVisible && !matched ? textCaseInsensitiveFailureSamples(viewport, check) : []
       };
     });
     const matches = results.map((result) => result.matched);
@@ -3025,6 +3062,32 @@ function textMatchSamples(sample, check) {
   const sampleText = textSampleAroundMatch(source, source.indexOf(text), text.length);
   return sampleText ? [sampleText] : [];
 }
+function textCaseInsensitiveSamples(sample, check) {
+  const source = String(sample || "");
+  const text = check.pattern ? "" : check.text || "";
+  if (!source || !text) return [];
+  const sampleText = textSampleAroundMatch(source, source.toLowerCase().indexOf(text.toLowerCase()), text.length);
+  return sampleText ? [sampleText] : [];
+}
+function textCaseInsensitiveSequenceSamples(texts, check) {
+  const text = check.pattern ? "" : compactTextEvidenceSample(check.text || "");
+  if (!text) return [];
+  const expected = text.toLowerCase();
+  return (texts || [])
+    .map((candidate) => compactTextEvidenceSample(candidate))
+    .filter((candidate) => candidate && candidate.toLowerCase().includes(expected))
+    .slice(0, 3)
+    .map((candidate) => candidate.slice(0, 240));
+}
+function textCaseInsensitiveFailureSamples(viewport, check) {
+  const key = check.pattern ? "pattern:" + check.pattern + "/" + (check.flags || "") : "text:" + (check.text || "");
+  const captured = viewport && viewport.text_case_insensitive_samples && Array.isArray(viewport.text_case_insensitive_samples[key]) ? viewport.text_case_insensitive_samples[key] : [];
+  const capturedSamples = captured
+    .map((sample) => compactTextEvidenceSample(sample).slice(0, 240))
+    .filter(Boolean);
+  if (capturedSamples.length) return capturedSamples.slice(0, 3);
+  return textCaseInsensitiveSamples(viewport && viewport.body_text_sample || "", check).slice(0, 3);
+}
 function textCheckFailureSamples(viewport, check) {
   const key = check.pattern ? "pattern:" + check.pattern + "/" + (check.flags || "") : "text:" + (check.text || "");
   const captured = viewport && viewport.text_match_samples && Array.isArray(viewport.text_match_samples[key]) ? viewport.text_match_samples[key] : [];
@@ -3983,6 +4046,9 @@ function assessProfile(profile, evidence) {
         const matched = matches.length > 0;
         const failedAgainstExpectation = matched !== expectedVisible;
         const sampleTexts = matches.length ? matches : failedAgainstExpectation ? texts : [];
+        const caseInsensitiveSamples = failedAgainstExpectation && expectedVisible && !matched
+          ? textCaseInsensitiveSequenceSamples(texts, check)
+          : [];
         return {
           viewport: viewport.name,
           selector_count: viewport.selectors && viewport.selectors[selector] ? viewport.selectors[selector].count : 0,
@@ -3990,6 +4056,7 @@ function assessProfile(profile, evidence) {
           matched_count: matches.length,
           matched,
           samples: sampleTexts.slice(0, 3).map((text) => text.slice(0, 240)),
+          case_insensitive_samples: caseInsensitiveSamples,
         };
       });
       const failed = results.filter((result) => result.matched !== expectedVisible).length;
@@ -4121,6 +4188,9 @@ function assessProfile(profile, evidence) {
           viewport: viewport.name,
           matched,
           samples: failedAgainstExpectation ? textCheckFailureSamples(viewport, check) : [],
+          case_insensitive_samples: failedAgainstExpectation && expectedVisible && !matched
+            ? textCaseInsensitiveFailureSamples(viewport, check)
+            : [],
         };
       });
       const matches = results.map((result) => result.matched);
@@ -4510,6 +4580,14 @@ function setupTextMatches(sample, action) {
   return rawSample.includes(expected)
     || normalizeSetupMatchText(rawSample).includes(normalizeSetupMatchText(expected));
 }
+function setupCaseInsensitiveTextSample(sample, action) {
+  if (!action || action.pattern || !action.text) return "";
+  const normalizedSample = normalizeSetupMatchText(sample);
+  const normalizedExpected = normalizeSetupMatchText(action.text);
+  if (!normalizedSample || !normalizedExpected) return "";
+  if (!normalizedSample.toLowerCase().includes(normalizedExpected.toLowerCase())) return "";
+  return compactSetupResultText(normalizedSample);
+}
 async function waitForAnyVisibleSelector(context, selector, timeout) {
   const deadline = Date.now() + setupNumber(timeout, 15000);
   let lastReason = "selector_not_found";
@@ -4956,23 +5034,75 @@ async function executeSetupAction(action, ordinal, viewport) {
       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);
+      const pointerType = String(action.pointer_type || action.pointerType || "mouse").trim().toLowerCase();
+      if (pointerType === "touch" || pointerType === "pen") {
+        const localStart = {
+          x: coordinate(fromX, box.width),
+          y: coordinate(fromY, box.height),
+        };
+        const localEnd = {
+          x: coordinate(toX, box.width),
+          y: coordinate(toY, box.height),
+        };
+        await target.evaluate(async (element, payload) => {
+          const wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+          const rect = element.getBoundingClientRect();
+          const pointerId = payload.pointerType === "touch" ? 11 : 12;
+          const point = (progress) => ({
+            clientX: rect.left + payload.start.x + (payload.end.x - payload.start.x) * progress,
+            clientY: rect.top + payload.start.y + (payload.end.y - payload.start.y) * progress,
+          });
+          const dispatch = (type, progress) => {
+            const coords = point(progress);
+            element.dispatchEvent(new PointerEvent(type, {
+              bubbles: true,
+              cancelable: true,
+              composed: true,
+              pointerId,
+              pointerType: payload.pointerType,
+              isPrimary: true,
+              buttons: type === "pointerup" ? 0 : 1,
+              button: type === "pointerup" ? 0 : 0,
+              clientX: coords.clientX,
+              clientY: coords.clientY,
+            }));
+          };
+          dispatch("pointerover", 0);
+          dispatch("pointerenter", 0);
+          dispatch("pointerdown", 0);
+          for (let step = 1; step <= payload.steps; step += 1) {
+            dispatch("pointermove", step / payload.steps);
+            if (payload.durationMs && payload.steps > 1) await wait(payload.durationMs / payload.steps);
           }
-        } else {
-          await page.mouse.move(end.x, end.y, { steps });
+          dispatch("pointerup", 1);
+          dispatch("pointerout", 1);
+          dispatch("pointerleave", 1);
+        }, {
+          pointerType,
+          start: localStart,
+          end: localEnd,
+          steps,
+          durationMs,
+        });
+      } else {
+        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(() => {});
         }
-      } finally {
-        await page.mouse.up().catch(() => {});
       }
       return {
         ...base,
@@ -4985,6 +5115,7 @@ async function executeSetupAction(action, ordinal, viewport) {
         from_y: fromY,
         to_x: toX,
         to_y: toY,
+        pointer_type: pointerType,
         steps,
         duration_ms: durationMs || undefined,
       };
@@ -5207,6 +5338,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       if (!count) return { ...base, reason: "selector_not_found", count };
       let targetIndex = Number.isInteger(action.index) ? action.index : 0;
       let matchedText = null;
+      let caseInsensitiveText = null;
       let hiddenMatchIndex = -1;
       let hiddenMatchedText = null;
       if (action.text || action.pattern) {
@@ -5224,10 +5356,12 @@ async function executeSetupAction(action, ordinal, viewport) {
               hiddenMatchIndex = index;
               hiddenMatchedText = compactSetupResultText(text);
             }
+          } else if (!caseInsensitiveText) {
+            caseInsensitiveText = setupCaseInsensitiveTextSample(text, action) || null;
           }
         }
         if (targetIndex < 0 && hiddenMatchIndex >= 0) return { ...base, reason: "matching_element_not_visible", count, target_index: hiddenMatchIndex, text: hiddenMatchedText };
-        if (targetIndex < 0) return { ...base, reason: "text_not_found", count };
+        if (targetIndex < 0) return { ...base, reason: "text_not_found", count, case_insensitive_text: caseInsensitiveText || undefined };
       }
       if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex };
       const clickOptions = action.force === true
@@ -5271,6 +5405,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       const locator = scope.context.locator(action.selector);
       const startedAt = Date.now();
       let lastText = "";
+      let caseInsensitiveText = "";
       while (Date.now() - startedAt <= timeout) {
         const count = await locator.count().catch(() => 0);
         for (let index = 0; index < count; index += 1) {
@@ -5279,10 +5414,11 @@ async function executeSetupAction(action, ordinal, viewport) {
           if (setupTextMatches(text, action)) {
             return { ...base, ...setupScopeEvidence(scope), ok: true, text: compactSetupResultText(text), target_index: index, timeout_ms: timeout };
           }
+          caseInsensitiveText = caseInsensitiveText || setupCaseInsensitiveTextSample(text, action);
         }
         await page.waitForTimeout(100);
       }
-      return { ...base, ...setupScopeEvidence(scope), reason: "text_not_found", text: compactSetupResultText(lastText), timeout_ms: timeout };
+      return { ...base, ...setupScopeEvidence(scope), reason: "text_not_found", text: compactSetupResultText(lastText), case_insensitive_text: caseInsensitiveText || undefined, timeout_ms: timeout };
     }
     if (type === "assert_text_visible" || type === "assert_text_absent") {
       const scope = await setupActionScope(action, timeout);
@@ -5291,6 +5427,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       const startedAt = Date.now();
       let lastText = "";
       let matchedText = "";
+      let caseInsensitiveText = "";
       let hiddenMatch = false;
       while (Date.now() - startedAt <= timeout) {
         const count = await locator.count().catch(() => 0);
@@ -5313,6 +5450,7 @@ async function executeSetupAction(action, ordinal, viewport) {
             }
             break;
           }
+          caseInsensitiveText = caseInsensitiveText || setupCaseInsensitiveTextSample(text, action);
         }
         if (type === "assert_text_absent" && !matched) {
           return { ...base, ...setupScopeEvidence(scope), ok: true, count, timeout_ms: timeout };
@@ -5323,7 +5461,7 @@ async function executeSetupAction(action, ordinal, viewport) {
         if (hiddenMatch) {
           return { ...base, ...setupScopeEvidence(scope), reason: "matching_element_not_visible", text: compactSetupResultText(matchedText), timeout_ms: timeout };
         }
-        return { ...base, ...setupScopeEvidence(scope), reason: "text_not_found", text: compactSetupResultText(lastText), timeout_ms: timeout };
+        return { ...base, ...setupScopeEvidence(scope), reason: "text_not_found", text: compactSetupResultText(lastText), case_insensitive_text: caseInsensitiveText || undefined, timeout_ms: timeout };
       }
       return { ...base, ...setupScopeEvidence(scope), reason: "text_still_present", text: compactSetupResultText(matchedText || lastText), timeout_ms: timeout };
     }
@@ -6431,6 +6569,7 @@ async function captureViewport(viewport) {
   const text_sequences = {};
   const text_matches = {};
   const text_match_samples = {};
+  const text_case_insensitive_samples = {};
   const http_statuses = {};
   const link_statuses = {};
   for (const check of profile.checks || []) {
@@ -6456,6 +6595,7 @@ async function captureViewport(viewport) {
       const sample = dom.body_text || dom.body_text_sample || "";
       text_matches[key] = textMatches(sample, check);
       text_match_samples[key] = textMatchSamples(sample, check);
+      text_case_insensitive_samples[key] = textCaseInsensitiveSamples(sample, check);
     }
     if ((check.type === "frame_text_visible" || check.type === "frame_url_equals" || check.type === "frame_url_matches" || check.type === "frame_no_horizontal_overflow") && check.selector) {
       selectors[check.selector] = selectors[check.selector] || await selectorStats(check.selector);
@@ -6533,6 +6673,7 @@ async function captureViewport(viewport) {
     text_sequences,
     text_matches,
     text_match_samples,
+    text_case_insensitive_samples,
     http_statuses,
     link_statuses,
     route_inventory: routeInventory,

package/dist/profile.d.cts

@@ -115,6 +115,7 @@ interface RiddleProofProfileSetupAction {
     force?: boolean;
     click_count?: number;
     coordinate_mode?: "pixels" | "ratio";
+    pointer_type?: "mouse" | "touch" | "pen";
     from_x?: number;
     from_y?: number;
     to_x?: number;
@@ -308,6 +309,7 @@ interface RiddleProofProfileViewportEvidence {
     text_sequences?: Record<string, Record<string, JsonValue>>;
     text_matches?: Record<string, boolean>;
     text_match_samples?: Record<string, string[]>;
+    text_case_insensitive_samples?: Record<string, string[]>;
     http_statuses?: Record<string, Record<string, JsonValue>>;
     link_statuses?: Record<string, Record<string, JsonValue>>;
     route_inventory?: Record<string, JsonValue>;

package/dist/profile.d.ts

@@ -115,6 +115,7 @@ interface RiddleProofProfileSetupAction {
     force?: boolean;
     click_count?: number;
     coordinate_mode?: "pixels" | "ratio";
+    pointer_type?: "mouse" | "touch" | "pen";
     from_x?: number;
     from_y?: number;
     to_x?: number;
@@ -308,6 +309,7 @@ interface RiddleProofProfileViewportEvidence {
     text_sequences?: Record<string, Record<string, JsonValue>>;
     text_matches?: Record<string, boolean>;
     text_match_samples?: Record<string, string[]>;
+    text_case_insensitive_samples?: Record<string, string[]>;
     http_statuses?: Record<string, Record<string, JsonValue>>;
     link_statuses?: Record<string, Record<string, JsonValue>>;
     route_inventory?: Record<string, JsonValue>;

package/dist/profile.js

@@ -23,7 +23,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-TDK6WFH3.js";
+} from "./chunk-ZYD2SGEM.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: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "recon" | "author" | "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: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "recon" | "author" | "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: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "recon" | "author" | "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: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "recon" | "author" | "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: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "recon" | "author" | "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: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "recon" | "author" | "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.129",
+  "version": "0.7.131",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",