@riddledc/riddle-proof 0.7.61 → 0.7.63

package/README.md

@@ -284,6 +284,15 @@ and setup assertions then execute in that frame context and record
 Use `frame_index` / `frameIndex` when more than one matching iframe is present;
 it defaults to the first frame.
 
+Profiles with setup actions also include a compact
+`setup_actions_succeeded.evidence.setup_summary`. The summary groups each
+viewport's final route, final URL, action counts, clicked targets, iframe URLs,
+compact text samples, and failures so setup-heavy clickthrough or iframe proofs
+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.
+
 `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`
 still overrides the profile value for one-off runs.

package/dist/{chunk-T66DWLBE.js → chunk-MLJHMZLR.js}

@@ -175,6 +175,87 @@ 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 sampleProfileSetupSummaryItems(items, limit) {
+  if (items.length <= limit) return items;
+  const firstCount = Math.floor(limit / 2);
+  const lastCount = limit - firstCount;
+  return [...items.slice(0, firstCount), ...items.slice(-lastCount)];
+}
+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 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 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,
+        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_total: clickedItems.length,
+        clicked_truncated: clickedItems.length > clicked.length,
+        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();
@@ -1281,6 +1362,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
@@ -1694,6 +1776,98 @@ 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 sampleProfileSetupSummaryItems(items, limit) {
+  if ((items || []).length <= limit) return items || [];
+  const firstCount = Math.floor(limit / 2);
+  const lastCount = limit - firstCount;
+  return [...items.slice(0, firstCount), ...items.slice(-lastCount)];
+}
+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 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),
+        }));
+      const clicked = sampleProfileSetupSummaryItems(clickedItems, 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_total: clickedItems.length,
+        clicked_truncated: clickedItems.length > clicked.length,
+        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 || [];
@@ -1798,6 +1972,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,

package/dist/cli.cjs

@@ -7048,6 +7048,87 @@ 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 sampleProfileSetupSummaryItems(items, limit) {
+  if (items.length <= limit) return items;
+  const firstCount = Math.floor(limit / 2);
+  const lastCount = limit - firstCount;
+  return [...items.slice(0, firstCount), ...items.slice(-lastCount)];
+}
+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 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 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,
+        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_total: clickedItems.length,
+        clicked_truncated: clickedItems.length > clicked.length,
+        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 = stringValue2(value) || fallback;
   return name.replace(/\s+/g, " ").trim();
@@ -8154,6 +8235,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
@@ -8551,6 +8633,98 @@ 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 sampleProfileSetupSummaryItems(items, limit) {
+  if ((items || []).length <= limit) return items || [];
+  const firstCount = Math.floor(limit / 2);
+  const lastCount = limit - firstCount;
+  return [...items.slice(0, firstCount), ...items.slice(-lastCount)];
+}
+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 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),
+        }));
+      const clicked = sampleProfileSetupSummaryItems(clickedItems, 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_total: clickedItems.length,
+        clicked_truncated: clickedItems.length > clicked.length,
+        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 || [];
@@ -8655,6 +8829,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,

package/dist/cli.js

@@ -10,7 +10,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-T66DWLBE.js";
+} from "./chunk-MLJHMZLR.js";
 import {
   createRiddleApiClient,
   parseRiddleViewport

package/dist/index.cjs

@@ -8889,6 +8889,87 @@ function toJsonValue(value) {
   if (isRecord2(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 (!isRecord2(container) || !Array.isArray(container.frames)) continue;
+    for (const frame of container.frames) {
+      if (!isRecord2(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 sampleProfileSetupSummaryItems(items, limit) {
+  if (items.length <= limit) return items;
+  const firstCount = Math.floor(limit / 2);
+  const lastCount = limit - firstCount;
+  return [...items.slice(0, firstCount), ...items.slice(-lastCount)];
+}
+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 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 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,
+        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_total: clickedItems.length,
+        clicked_truncated: clickedItems.length > clicked.length,
+        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 = stringValue5(value) || fallback;
   return name.replace(/\s+/g, " ").trim();
@@ -9995,6 +10076,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
@@ -10408,6 +10490,98 @@ 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 sampleProfileSetupSummaryItems(items, limit) {
+  if ((items || []).length <= limit) return items || [];
+  const firstCount = Math.floor(limit / 2);
+  const lastCount = limit - firstCount;
+  return [...items.slice(0, firstCount), ...items.slice(-lastCount)];
+}
+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 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),
+        }));
+      const clicked = sampleProfileSetupSummaryItems(clickedItems, 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_total: clickedItems.length,
+        clicked_truncated: clickedItems.length > clicked.length,
+        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 || [];
@@ -10512,6 +10686,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,

package/dist/index.js

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

package/dist/profile.cjs

@@ -218,6 +218,87 @@ 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 sampleProfileSetupSummaryItems(items, limit) {
+  if (items.length <= limit) return items;
+  const firstCount = Math.floor(limit / 2);
+  const lastCount = limit - firstCount;
+  return [...items.slice(0, firstCount), ...items.slice(-lastCount)];
+}
+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 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 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,
+        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_total: clickedItems.length,
+        clicked_truncated: clickedItems.length > clicked.length,
+        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();
@@ -1324,6 +1405,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
@@ -1737,6 +1819,98 @@ 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 sampleProfileSetupSummaryItems(items, limit) {
+  if ((items || []).length <= limit) return items || [];
+  const firstCount = Math.floor(limit / 2);
+  const lastCount = limit - firstCount;
+  return [...items.slice(0, firstCount), ...items.slice(-lastCount)];
+}
+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 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),
+        }));
+      const clicked = sampleProfileSetupSummaryItems(clickedItems, 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_total: clickedItems.length,
+        clicked_truncated: clickedItems.length > clicked.length,
+        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 || [];
@@ -1841,6 +2015,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,

package/dist/profile.js

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