@riddledc/riddle-proof 0.7.128 → 0.7.130

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,
@@ -1901,6 +1914,49 @@ function matchText(sample, check) {
   }
   return sample.includes(check.text || "");
 }
+function compactTextEvidenceSample(value) {
+  return String(value || "").replace(/\s+/g, " ").trim();
+}
+function textSampleAroundMatch(sample, index, length) {
+  if (index < 0) return void 0;
+  const source = String(sample || "");
+  const context = 120;
+  const start = Math.max(0, index - context);
+  const end = Math.min(source.length, index + Math.max(length, 1) + context);
+  const prefix = start > 0 ? "..." : "";
+  const suffix = end < source.length ? "..." : "";
+  const compacted = compactTextEvidenceSample(`${prefix}${source.slice(start, end)}${suffix}`);
+  return compacted ? compacted.slice(0, 240) : void 0;
+}
+function textMatchSamples(sample, check) {
+  const source = String(sample || "");
+  if (!source) return [];
+  if (check.pattern) {
+    try {
+      const flags = Array.from(new Set(String(check.flags || "").replace(/[gy]/g, "").split(""))).join("");
+      const match = new RegExp(check.pattern, flags).exec(source);
+      const sampleText2 = match ? textSampleAroundMatch(source, match.index, match[0]?.length || 1) : void 0;
+      return sampleText2 ? [sampleText2] : [];
+    } catch {
+      return [];
+    }
+  }
+  const text = check.text || "";
+  if (!text) return [];
+  const index = source.indexOf(text);
+  const sampleText = textSampleAroundMatch(source, index, text.length);
+  return sampleText ? [sampleText] : [];
+}
+function textCheckFailureSamples(viewport, check) {
+  const key = textKey(check);
+  const captured = viewport.text_match_samples?.[key] || [];
+  const capturedSamples = captured.map((sample) => compactTextEvidenceSample(sample).slice(0, 240)).filter(Boolean);
+  if (capturedSamples.length) return capturedSamples.slice(0, 3);
+  const matchedSamples = textMatchSamples(viewport.body_text_sample || "", check);
+  if (matchedSamples.length) return matchedSamples.slice(0, 3);
+  const fallback = compactTextEvidenceSample(viewport.body_text_sample || "").slice(0, 240);
+  return fallback ? [fallback] : [];
+}
 function allowedMessageSample(input) {
   if (!isRecord(input)) return String(input || "");
   const parts = [
@@ -2345,10 +2401,17 @@ function assessCheckFromEvidence(check, evidence) {
   if (check.type === "text_visible" || check.type === "text_absent") {
     const key = textKey(check);
     const expectedVisible = check.type === "text_visible";
-    const matches = viewports.map((viewport) => {
+    const results = viewports.map((viewport) => {
       const fromEvidence = viewport.text_matches?.[key];
-      return typeof fromEvidence === "boolean" ? fromEvidence : matchText(viewport.body_text_sample || "", check);
+      const matched = typeof fromEvidence === "boolean" ? fromEvidence : matchText(viewport.body_text_sample || "", check);
+      const failedAgainstExpectation = matched !== expectedVisible;
+      return {
+        viewport: viewport.name,
+        matched,
+        samples: failedAgainstExpectation ? textCheckFailureSamples(viewport, check) : []
+      };
     });
+    const matches = results.map((result) => result.matched);
     const failed = matches.filter((matched) => matched !== expectedVisible).length;
     return {
       type: check.type,
@@ -2357,7 +2420,8 @@ function assessCheckFromEvidence(check, evidence) {
       evidence: {
         text: check.text || null,
         pattern: check.pattern || null,
-        matches
+        matches,
+        viewports: results.map((result) => toJsonValue(result))
       },
       message: failed ? `Text assertion failed in ${failed} viewport(s).` : void 0
     };
@@ -2944,6 +3008,48 @@ function textMatches(sample, check) {
   }
   return String(sample || "").includes(check.text || "");
 }
+function compactTextEvidenceSample(value) {
+  return String(value || "").replace(/\s+/g, " ").trim();
+}
+function textSampleAroundMatch(sample, index, length) {
+  if (index < 0) return undefined;
+  const source = String(sample || "");
+  const context = 120;
+  const start = Math.max(0, index - context);
+  const end = Math.min(source.length, index + Math.max(length, 1) + context);
+  const prefix = start > 0 ? "..." : "";
+  const suffix = end < source.length ? "..." : "";
+  const compacted = compactTextEvidenceSample(prefix + source.slice(start, end) + suffix);
+  return compacted ? compacted.slice(0, 240) : undefined;
+}
+function textMatchSamples(sample, check) {
+  const source = String(sample || "");
+  if (!source) return [];
+  if (check.pattern) {
+    try {
+      const flags = Array.from(new Set(String(check.flags || "").replace(/[gy]/g, "").split(""))).join("");
+      const match = new RegExp(check.pattern, flags).exec(source);
+      const sampleText = match ? textSampleAroundMatch(source, match.index, match[0] ? match[0].length : 1) : undefined;
+      return sampleText ? [sampleText] : [];
+    } catch { return []; }
+  }
+  const text = check.text || "";
+  if (!text) return [];
+  const sampleText = textSampleAroundMatch(source, source.indexOf(text), text.length);
+  return sampleText ? [sampleText] : [];
+}
+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] : [];
+  const capturedSamples = captured
+    .map((sample) => compactTextEvidenceSample(sample).slice(0, 240))
+    .filter(Boolean);
+  if (capturedSamples.length) return capturedSamples.slice(0, 3);
+  const matchedSamples = textMatchSamples(viewport && viewport.body_text_sample || "", check);
+  if (matchedSamples.length) return matchedSamples.slice(0, 3);
+  const fallback = compactTextEvidenceSample(viewport && viewport.body_text_sample || "").slice(0, 240);
+  return fallback ? [fallback] : [];
+}
 function allowedMessageSample(input) {
   if (!input || typeof input !== "object" || Array.isArray(input)) return String(input || "");
   const parts = [
@@ -4021,13 +4127,22 @@ function assessProfile(profile, evidence) {
     if (check.type === "text_visible" || check.type === "text_absent") {
       const key = check.pattern ? "pattern:" + check.pattern + "/" + (check.flags || "") : "text:" + (check.text || "");
       const expectedVisible = check.type === "text_visible";
-      const matches = checkViewports.map((viewport) => viewport.text_matches && typeof viewport.text_matches[key] === "boolean" ? viewport.text_matches[key] : textMatches(viewport.body_text_sample || "", check));
+      const results = checkViewports.map((viewport) => {
+        const matched = viewport.text_matches && typeof viewport.text_matches[key] === "boolean" ? viewport.text_matches[key] : textMatches(viewport.body_text_sample || "", check);
+        const failedAgainstExpectation = matched !== expectedVisible;
+        return {
+          viewport: viewport.name,
+          matched,
+          samples: failedAgainstExpectation ? textCheckFailureSamples(viewport, check) : [],
+        };
+      });
+      const matches = results.map((result) => result.matched);
       const failed = matches.filter((matched) => matched !== expectedVisible).length;
       checks.push({
         type: check.type,
         label: check.label || check.type,
         status: failed ? "failed" : "passed",
-        evidence: { text: check.text, pattern: check.pattern, matches },
+        evidence: { text: check.text, pattern: check.pattern, matches, viewports: results },
         message: failed ? "Text assertion failed in " + failed + " viewport(s)." : undefined,
       });
       continue;
@@ -4347,6 +4462,36 @@ function textMatches(sample, check) {
   }
   return String(sample || "").includes(check.text || "");
 }
+function compactTextEvidenceSample(value) {
+  return String(value || "").replace(/\s+/g, " ").trim();
+}
+function textSampleAroundMatch(sample, index, length) {
+  if (index < 0) return undefined;
+  const source = String(sample || "");
+  const context = 120;
+  const start = Math.max(0, index - context);
+  const end = Math.min(source.length, index + Math.max(length, 1) + context);
+  const prefix = start > 0 ? "..." : "";
+  const suffix = end < source.length ? "..." : "";
+  const compacted = compactTextEvidenceSample(prefix + source.slice(start, end) + suffix);
+  return compacted ? compacted.slice(0, 240) : undefined;
+}
+function textMatchSamples(sample, check) {
+  const source = String(sample || "");
+  if (!source) return [];
+  if (check.pattern) {
+    try {
+      const flags = Array.from(new Set(String(check.flags || "").replace(/[gy]/g, "").split(""))).join("");
+      const match = new RegExp(check.pattern, flags).exec(source);
+      const sampleText = match ? textSampleAroundMatch(source, match.index, match[0] ? match[0].length : 1) : undefined;
+      return sampleText ? [sampleText] : [];
+    } catch { return []; }
+  }
+  const text = check.text || "";
+  if (!text) return [];
+  const sampleText = textSampleAroundMatch(source, source.indexOf(text), text.length);
+  return sampleText ? [sampleText] : [];
+}
 function profileCheckAppliesToViewport(check, viewport) {
   if (!Array.isArray(check.viewports) || !check.viewports.length) return true;
   return Boolean(viewport && viewport.name && check.viewports.includes(viewport.name));
@@ -4824,23 +4969,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,
@@ -4853,6 +5050,7 @@ async function executeSetupAction(action, ordinal, viewport) {
         from_y: fromY,
         to_x: toX,
         to_y: toY,
+        pointer_type: pointerType,
         steps,
         duration_ms: durationMs || undefined,
       };
@@ -6298,6 +6496,7 @@ async function captureViewport(viewport) {
   const frames = {};
   const text_sequences = {};
   const text_matches = {};
+  const text_match_samples = {};
   const http_statuses = {};
   const link_statuses = {};
   for (const check of profile.checks || []) {
@@ -6319,7 +6518,10 @@ async function captureViewport(viewport) {
       text_sequences[check.selector] = await selectorTextSequence(check.selector);
     }
     if ((check.type === "text_visible" || check.type === "text_absent") && (check.text || check.pattern)) {
-      text_matches[textKey(check)] = textMatches(dom.body_text || dom.body_text_sample || "", check);
+      const key = textKey(check);
+      const sample = dom.body_text || dom.body_text_sample || "";
+      text_matches[key] = textMatches(sample, check);
+      text_match_samples[key] = textMatchSamples(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);
@@ -6396,6 +6598,7 @@ async function captureViewport(viewport) {
     frames,
     text_sequences,
     text_matches,
+    text_match_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;
@@ -307,6 +308,7 @@ interface RiddleProofProfileViewportEvidence {
     frames?: Record<string, Record<string, JsonValue>>;
     text_sequences?: Record<string, Record<string, JsonValue>>;
     text_matches?: Record<string, boolean>;
+    text_match_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;
@@ -307,6 +308,7 @@ interface RiddleProofProfileViewportEvidence {
     frames?: Record<string, Record<string, JsonValue>>;
     text_sequences?: Record<string, Record<string, JsonValue>>;
     text_matches?: Record<string, boolean>;
+    text_match_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-TO3FVF5S.js";
+} from "./chunk-ZJNM3YAB.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: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "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: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "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: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "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: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "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: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "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: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
     state_path: string;
     stage: any;
     summary: string;

package/package.json

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