@riddledc/riddle-proof 0.7.138 → 0.7.140

package/README.md

@@ -482,6 +482,14 @@ and `click_count_value_total`.
 profile carries its own hosted Riddle worker budget; an explicit CLI `--timeout`
 still overrides the profile value for one-off runs.
 
+Profile final viewport screenshots are full-page by default. Set
+`target.screenshot_full_page: false`, `target.screenshotFullPage: false`, or
+`target.screenshot_mode: "viewport"` when the automatic final screenshots
+should capture only the current viewport, for example when fixed or sticky
+headers make full-page captures misleading. Compact profile summaries include
+the final screenshot count and mode when a profile sets an explicit target
+screenshot mode.
+
 Use `allowed_console_patterns` / `allowed_console_texts` on
 `no_fatal_console_errors` when a negative-path profile intentionally triggers a
 known browser console error, such as a mocked `503` that the app recovers from:

package/dist/{chunk-N75EAJNG.js → chunk-6VXZ6V5M.js}

@@ -494,12 +494,18 @@ function profileScreenshotLabels(viewports) {
   }
   return labels;
 }
-function profileSetupSummary(viewports, actionCount, expectedActionCountByViewport) {
+function profileSetupSummary(viewports, actionCount, expectedActionCountByViewport, finalScreenshotFullPage) {
+  const normalizedFinalScreenshotFullPage = finalScreenshotFullPage === void 0 ? void 0 : finalScreenshotFullPage !== false;
+  const finalScreenshotCount = viewports.filter((viewport) => typeof viewport.screenshot_label === "string" && viewport.screenshot_label.trim()).length;
   return toJsonValue({
     viewport_count: viewports.length,
     action_count: actionCount ?? null,
+    final_screenshot_count: finalScreenshotCount,
+    final_screenshot_full_page: normalizedFinalScreenshotFullPage ?? null,
+    final_screenshot_mode: normalizedFinalScreenshotFullPage === void 0 ? null : normalizedFinalScreenshotFullPage ? "full_page" : "viewport",
     viewports: viewports.map((viewport) => {
       const expectedActionCount = expectedActionCountByViewport?.get(viewport.name) ?? actionCount;
+      const viewportFinalScreenshotFullPage = typeof viewport.screenshot_full_page === "boolean" ? viewport.screenshot_full_page : normalizedFinalScreenshotFullPage;
       const results = viewport.setup_action_results || [];
       const failed = results.filter((result) => result.ok === false && result.optional !== true);
       const optionalFailed = results.filter((result) => result.ok === false && result.optional === true);
@@ -539,6 +545,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
         action_counts: profileSetupActionCounts(results),
         frame_action_count: results.filter((result) => result.frame_selector).length,
         frame_urls: profileSetupFrameUrls(viewport),
+        final_screenshot: viewport.screenshot_label ?? null,
+        final_screenshot_full_page: viewportFinalScreenshotFullPage ?? null,
         setup_screenshots: profileSetupScreenshotLabels(results),
         clicked_total: clickedItems.length,
         clicked_truncated: clickedItems.length > clicked.length,
@@ -875,6 +883,42 @@ function normalizeSetupActions(value) {
   if (!Array.isArray(value)) throw new Error("target.setup_actions must be an array.");
   return value.map(normalizeSetupAction);
 }
+function normalizeTargetScreenshotFullPage(input) {
+  const directFullPage = booleanValue(valueFromOwn(
+    input,
+    "screenshot_full_page",
+    "screenshotFullPage",
+    "final_screenshot_full_page",
+    "finalScreenshotFullPage",
+    "full_page_screenshots",
+    "fullPageScreenshots"
+  ));
+  const viewportOnly = booleanValue(valueFromOwn(
+    input,
+    "viewport_screenshots",
+    "viewportScreenshots",
+    "viewport_only_screenshots",
+    "viewportOnlyScreenshots"
+  ));
+  const modeInput = stringFromOwn(input, "screenshot_mode", "screenshotMode", "final_screenshot_mode", "finalScreenshotMode");
+  let modeFullPage;
+  if (modeInput) {
+    const mode = modeInput.trim().toLowerCase().replace(/[-\s]+/g, "_");
+    if (mode === "full_page" || mode === "fullpage" || mode === "page" || mode === "document") {
+      modeFullPage = true;
+    } else if (mode === "viewport" || mode === "view") {
+      modeFullPage = false;
+    } else {
+      throw new Error(`target.screenshot_mode ${modeInput} is not supported. Supported modes: full_page, viewport.`);
+    }
+  }
+  const values = [directFullPage, viewportOnly === void 0 ? void 0 : !viewportOnly, modeFullPage].filter((value) => value !== void 0);
+  if (!values.length) return void 0;
+  if (values.some((value) => value !== values[0])) {
+    throw new Error("target has conflicting screenshot full_page / viewport mode options.");
+  }
+  return values[0];
+}
 function normalizeNetworkMock(input, index) {
   if (!isRecord(input)) throw new Error(`target.network_mocks[${index}] must be an object.`);
   const url = stringValue(input.url) || stringValue(input.glob) || stringValue(input.pattern);
@@ -1443,6 +1487,7 @@ function normalizeRiddleProofProfile(input, options = {}) {
       timeout_sec: timeoutSecValue(targetInput.timeout_sec) ?? timeoutSecValue(targetInput.timeoutSec) ?? timeoutSecValue(targetInput.riddle_timeout_sec) ?? timeoutSecValue(targetInput.riddleTimeoutSec),
       wait_for_selector: stringValue(targetInput.wait_for_selector) || stringValue(targetInput.waitForSelector),
       wait_ms: numberValue(targetInput.wait_ms) ?? numberValue(targetInput.waitMs),
+      screenshot_full_page: normalizeTargetScreenshotFullPage(targetInput),
       setup_actions: normalizeSetupActions(targetInput.setup_actions ?? targetInput.setupActions),
       network_mocks: normalizeNetworkMocks(targetInput.network_mocks ?? targetInput.networkMocks)
     },
@@ -2746,7 +2791,7 @@ function assessSetupActionsFromEvidence(profile, evidence) {
         ok: (viewport.setup_action_results || []).length >= (expectedActionCountByViewport.get(viewport.name) ?? actionCount) && (viewport.setup_action_results || []).every((result) => result.ok !== false || result.optional === true),
         result_count: (viewport.setup_action_results || []).length
       })),
-      setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountByViewport),
+      setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountByViewport, profile.target.screenshot_full_page),
       failed
     },
     message: failed.length ? `Setup actions failed in ${failed.length} viewport action(s).` : void 0
@@ -3766,14 +3811,28 @@ function profileScreenshotLabels(viewports) {
   }
   return labels;
 }
-function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport) {
+function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport, finalScreenshotFullPage) {
+  const normalizedFinalScreenshotFullPage = finalScreenshotFullPage === undefined
+    ? undefined
+    : finalScreenshotFullPage !== false;
+  const finalScreenshotCount = (viewports || []).filter((viewport) => viewport && typeof viewport.screenshot_label === "string" && viewport.screenshot_label.trim()).length;
   return {
     viewport_count: (viewports || []).length,
     action_count: actionCount ?? null,
+    final_screenshot_count: finalScreenshotCount,
+    final_screenshot_full_page: normalizedFinalScreenshotFullPage ?? null,
+    final_screenshot_mode: normalizedFinalScreenshotFullPage === undefined
+      ? null
+      : normalizedFinalScreenshotFullPage
+        ? "full_page"
+        : "viewport",
     viewports: (viewports || []).map((viewport) => {
       const expectedActionCount = expectedActionCountsByViewport && expectedActionCountsByViewport[viewport.name] !== undefined
         ? expectedActionCountsByViewport[viewport.name]
         : actionCount;
+      const viewportFinalScreenshotFullPage = typeof viewport.screenshot_full_page === "boolean"
+        ? viewport.screenshot_full_page
+        : normalizedFinalScreenshotFullPage;
       const results = viewport.setup_action_results || [];
       const failed = results.filter((result) => result && result.ok === false && result.optional !== true);
       const optionalFailed = results.filter((result) => result && result.ok === false && result.optional === true);
@@ -3827,6 +3886,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         action_counts: profileSetupActionCounts(results),
         frame_action_count: results.filter((result) => result && result.frame_selector).length,
         frame_urls: profileSetupFrameUrls(viewport),
+        final_screenshot: viewport.screenshot_label || null,
+        final_screenshot_full_page: viewportFinalScreenshotFullPage ?? null,
         setup_screenshots: profileSetupScreenshotLabels(results),
         clicked_total: clickedItems.length,
         clicked_truncated: clickedItems.length > clicked.length,
@@ -4011,7 +4072,7 @@ function assessProfile(profile, evidence) {
             && (viewport.setup_action_results || []).every((result) => !result || result.ok !== false || result.optional === true),
           result_count: (viewport.setup_action_results || []).length,
         })),
-        setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport),
+        setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport, profile.target && profile.target.screenshot_full_page),
         failed,
       },
       message: failed.length ? "Setup actions failed in " + failed.length + " viewport action(s)." : undefined,
@@ -6889,8 +6950,14 @@ async function captureViewport(viewport) {
     }
   }
   const screenshotLabel = profileSlug + "-" + viewport.name;
+  let screenshotFullPage = null;
   try {
-    if (typeof saveScreenshot === "function") await saveScreenshot(screenshotLabel);
+    const screenshotOptions = {};
+    if (profile.target && profile.target.screenshot_full_page !== undefined) {
+      screenshotFullPage = profile.target.screenshot_full_page !== false;
+      screenshotOptions.fullPage = screenshotFullPage;
+    }
+    if (typeof saveScreenshot === "function") await saveScreenshot(screenshotLabel, screenshotOptions);
   } catch (error) {
     pageErrors.push({ message: "saveScreenshot failed: " + String(error && error.message ? error.message : error).slice(0, 500) });
   }
@@ -6957,6 +7024,7 @@ async function captureViewport(viewport) {
     route_inventory: routeInventory,
     setup_action_results: setupActionResults,
     screenshot_label: screenshotLabel,
+    screenshot_full_page: screenshotFullPage,
     navigation_error: navigationError,
     wait_error: waitError,
   };

package/dist/cli.cjs

@@ -7431,12 +7431,18 @@ function profileScreenshotLabels(viewports) {
   }
   return labels;
 }
-function profileSetupSummary(viewports, actionCount, expectedActionCountByViewport) {
+function profileSetupSummary(viewports, actionCount, expectedActionCountByViewport, finalScreenshotFullPage) {
+  const normalizedFinalScreenshotFullPage = finalScreenshotFullPage === void 0 ? void 0 : finalScreenshotFullPage !== false;
+  const finalScreenshotCount = viewports.filter((viewport) => typeof viewport.screenshot_label === "string" && viewport.screenshot_label.trim()).length;
   return toJsonValue({
     viewport_count: viewports.length,
     action_count: actionCount ?? null,
+    final_screenshot_count: finalScreenshotCount,
+    final_screenshot_full_page: normalizedFinalScreenshotFullPage ?? null,
+    final_screenshot_mode: normalizedFinalScreenshotFullPage === void 0 ? null : normalizedFinalScreenshotFullPage ? "full_page" : "viewport",
     viewports: viewports.map((viewport) => {
       const expectedActionCount = expectedActionCountByViewport?.get(viewport.name) ?? actionCount;
+      const viewportFinalScreenshotFullPage = typeof viewport.screenshot_full_page === "boolean" ? viewport.screenshot_full_page : normalizedFinalScreenshotFullPage;
       const results = viewport.setup_action_results || [];
       const failed = results.filter((result) => result.ok === false && result.optional !== true);
       const optionalFailed = results.filter((result) => result.ok === false && result.optional === true);
@@ -7476,6 +7482,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
         action_counts: profileSetupActionCounts(results),
         frame_action_count: results.filter((result) => result.frame_selector).length,
         frame_urls: profileSetupFrameUrls(viewport),
+        final_screenshot: viewport.screenshot_label ?? null,
+        final_screenshot_full_page: viewportFinalScreenshotFullPage ?? null,
         setup_screenshots: profileSetupScreenshotLabels(results),
         clicked_total: clickedItems.length,
         clicked_truncated: clickedItems.length > clicked.length,
@@ -7812,6 +7820,42 @@ function normalizeSetupActions(value) {
   if (!Array.isArray(value)) throw new Error("target.setup_actions must be an array.");
   return value.map(normalizeSetupAction);
 }
+function normalizeTargetScreenshotFullPage(input) {
+  const directFullPage = booleanValue(valueFromOwn(
+    input,
+    "screenshot_full_page",
+    "screenshotFullPage",
+    "final_screenshot_full_page",
+    "finalScreenshotFullPage",
+    "full_page_screenshots",
+    "fullPageScreenshots"
+  ));
+  const viewportOnly = booleanValue(valueFromOwn(
+    input,
+    "viewport_screenshots",
+    "viewportScreenshots",
+    "viewport_only_screenshots",
+    "viewportOnlyScreenshots"
+  ));
+  const modeInput = stringFromOwn(input, "screenshot_mode", "screenshotMode", "final_screenshot_mode", "finalScreenshotMode");
+  let modeFullPage;
+  if (modeInput) {
+    const mode = modeInput.trim().toLowerCase().replace(/[-\s]+/g, "_");
+    if (mode === "full_page" || mode === "fullpage" || mode === "page" || mode === "document") {
+      modeFullPage = true;
+    } else if (mode === "viewport" || mode === "view") {
+      modeFullPage = false;
+    } else {
+      throw new Error(`target.screenshot_mode ${modeInput} is not supported. Supported modes: full_page, viewport.`);
+    }
+  }
+  const values = [directFullPage, viewportOnly === void 0 ? void 0 : !viewportOnly, modeFullPage].filter((value) => value !== void 0);
+  if (!values.length) return void 0;
+  if (values.some((value) => value !== values[0])) {
+    throw new Error("target has conflicting screenshot full_page / viewport mode options.");
+  }
+  return values[0];
+}
 function normalizeNetworkMock(input, index) {
   if (!isRecord(input)) throw new Error(`target.network_mocks[${index}] must be an object.`);
   const url = stringValue2(input.url) || stringValue2(input.glob) || stringValue2(input.pattern);
@@ -8380,6 +8424,7 @@ function normalizeRiddleProofProfile(input, options = {}) {
       timeout_sec: timeoutSecValue(targetInput.timeout_sec) ?? timeoutSecValue(targetInput.timeoutSec) ?? timeoutSecValue(targetInput.riddle_timeout_sec) ?? timeoutSecValue(targetInput.riddleTimeoutSec),
       wait_for_selector: stringValue2(targetInput.wait_for_selector) || stringValue2(targetInput.waitForSelector),
       wait_ms: numberValue(targetInput.wait_ms) ?? numberValue(targetInput.waitMs),
+      screenshot_full_page: normalizeTargetScreenshotFullPage(targetInput),
       setup_actions: normalizeSetupActions(targetInput.setup_actions ?? targetInput.setupActions),
       network_mocks: normalizeNetworkMocks(targetInput.network_mocks ?? targetInput.networkMocks)
     },
@@ -9683,7 +9728,7 @@ function assessSetupActionsFromEvidence(profile, evidence) {
         ok: (viewport.setup_action_results || []).length >= (expectedActionCountByViewport.get(viewport.name) ?? actionCount) && (viewport.setup_action_results || []).every((result) => result.ok !== false || result.optional === true),
         result_count: (viewport.setup_action_results || []).length
       })),
-      setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountByViewport),
+      setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountByViewport, profile.target.screenshot_full_page),
       failed
     },
     message: failed.length ? `Setup actions failed in ${failed.length} viewport action(s).` : void 0
@@ -10687,14 +10732,28 @@ function profileScreenshotLabels(viewports) {
   }
   return labels;
 }
-function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport) {
+function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport, finalScreenshotFullPage) {
+  const normalizedFinalScreenshotFullPage = finalScreenshotFullPage === undefined
+    ? undefined
+    : finalScreenshotFullPage !== false;
+  const finalScreenshotCount = (viewports || []).filter((viewport) => viewport && typeof viewport.screenshot_label === "string" && viewport.screenshot_label.trim()).length;
   return {
     viewport_count: (viewports || []).length,
     action_count: actionCount ?? null,
+    final_screenshot_count: finalScreenshotCount,
+    final_screenshot_full_page: normalizedFinalScreenshotFullPage ?? null,
+    final_screenshot_mode: normalizedFinalScreenshotFullPage === undefined
+      ? null
+      : normalizedFinalScreenshotFullPage
+        ? "full_page"
+        : "viewport",
     viewports: (viewports || []).map((viewport) => {
       const expectedActionCount = expectedActionCountsByViewport && expectedActionCountsByViewport[viewport.name] !== undefined
         ? expectedActionCountsByViewport[viewport.name]
         : actionCount;
+      const viewportFinalScreenshotFullPage = typeof viewport.screenshot_full_page === "boolean"
+        ? viewport.screenshot_full_page
+        : normalizedFinalScreenshotFullPage;
       const results = viewport.setup_action_results || [];
       const failed = results.filter((result) => result && result.ok === false && result.optional !== true);
       const optionalFailed = results.filter((result) => result && result.ok === false && result.optional === true);
@@ -10748,6 +10807,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         action_counts: profileSetupActionCounts(results),
         frame_action_count: results.filter((result) => result && result.frame_selector).length,
         frame_urls: profileSetupFrameUrls(viewport),
+        final_screenshot: viewport.screenshot_label || null,
+        final_screenshot_full_page: viewportFinalScreenshotFullPage ?? null,
         setup_screenshots: profileSetupScreenshotLabels(results),
         clicked_total: clickedItems.length,
         clicked_truncated: clickedItems.length > clicked.length,
@@ -10932,7 +10993,7 @@ function assessProfile(profile, evidence) {
             && (viewport.setup_action_results || []).every((result) => !result || result.ok !== false || result.optional === true),
           result_count: (viewport.setup_action_results || []).length,
         })),
-        setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport),
+        setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport, profile.target && profile.target.screenshot_full_page),
         failed,
       },
       message: failed.length ? "Setup actions failed in " + failed.length + " viewport action(s)." : undefined,
@@ -13810,8 +13871,14 @@ async function captureViewport(viewport) {
     }
   }
   const screenshotLabel = profileSlug + "-" + viewport.name;
+  let screenshotFullPage = null;
   try {
-    if (typeof saveScreenshot === "function") await saveScreenshot(screenshotLabel);
+    const screenshotOptions = {};
+    if (profile.target && profile.target.screenshot_full_page !== undefined) {
+      screenshotFullPage = profile.target.screenshot_full_page !== false;
+      screenshotOptions.fullPage = screenshotFullPage;
+    }
+    if (typeof saveScreenshot === "function") await saveScreenshot(screenshotLabel, screenshotOptions);
   } catch (error) {
     pageErrors.push({ message: "saveScreenshot failed: " + String(error && error.message ? error.message : error).slice(0, 500) });
   }
@@ -13878,6 +13945,7 @@ async function captureViewport(viewport) {
     route_inventory: routeInventory,
     setup_action_results: setupActionResults,
     screenshot_label: screenshotLabel,
+    screenshot_full_page: screenshotFullPage,
     navigation_error: navigationError,
     wait_error: waitError,
   };
@@ -14634,6 +14702,8 @@ function profileSetupSummaryMarkdown(result) {
   if (!viewports.length) return [];
   const declaredActions = cliFiniteNumber(setupSummary.action_count);
   const totalResults = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.result_count) || 0), 0);
+  const finalScreenshotCount = cliFiniteNumber(setupSummary.final_screenshot_count) ?? viewports.reduce((sum, viewport) => sum + (cliString(viewport.final_screenshot) || cliString(viewport.screenshot_label) ? 1 : 0), 0);
+  const finalScreenshotMode = cliString(setupSummary.final_screenshot_mode);
   const setupScreenshots = viewports.reduce((sum, viewport) => {
     const labels = Array.isArray(viewport.setup_screenshots) ? viewport.setup_screenshots : [];
     return sum + labels.filter((label) => typeof label === "string" && label.trim()).length;
@@ -14649,6 +14719,7 @@ function profileSetupSummaryMarkdown(result) {
   const failedTotal = viewports.reduce((sum, viewport) => sum + (Array.isArray(viewport.failed) ? viewport.failed.length : 0), 0);
   const lines = [
     `- setup actions: ${declaredActions === void 0 ? "unknown" : declaredActions} declared, ${totalResults} recorded result(s) across ${viewports.length} viewport(s)`,
+    ...finalScreenshotMode ? [`- final screenshots: ${finalScreenshotCount}, mode ${finalScreenshotMode}`] : [],
     `- setup screenshots: ${setupScreenshots}`,
     `- clicked targets: ${clickedTotal}${failedTotal ? `; failed setup actions: ${failedTotal}` : ""}`
   ];

package/dist/cli.js

@@ -12,7 +12,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-N75EAJNG.js";
+} from "./chunk-6VXZ6V5M.js";
 import {
   createRiddleApiClient,
   parseRiddleViewport
@@ -589,6 +589,8 @@ function profileSetupSummaryMarkdown(result) {
   if (!viewports.length) return [];
   const declaredActions = cliFiniteNumber(setupSummary.action_count);
   const totalResults = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.result_count) || 0), 0);
+  const finalScreenshotCount = cliFiniteNumber(setupSummary.final_screenshot_count) ?? viewports.reduce((sum, viewport) => sum + (cliString(viewport.final_screenshot) || cliString(viewport.screenshot_label) ? 1 : 0), 0);
+  const finalScreenshotMode = cliString(setupSummary.final_screenshot_mode);
   const setupScreenshots = viewports.reduce((sum, viewport) => {
     const labels = Array.isArray(viewport.setup_screenshots) ? viewport.setup_screenshots : [];
     return sum + labels.filter((label) => typeof label === "string" && label.trim()).length;
@@ -604,6 +606,7 @@ function profileSetupSummaryMarkdown(result) {
   const failedTotal = viewports.reduce((sum, viewport) => sum + (Array.isArray(viewport.failed) ? viewport.failed.length : 0), 0);
   const lines = [
     `- setup actions: ${declaredActions === void 0 ? "unknown" : declaredActions} declared, ${totalResults} recorded result(s) across ${viewports.length} viewport(s)`,
+    ...finalScreenshotMode ? [`- final screenshots: ${finalScreenshotCount}, mode ${finalScreenshotMode}`] : [],
     `- setup screenshots: ${setupScreenshots}`,
     `- clicked targets: ${clickedTotal}${failedTotal ? `; failed setup actions: ${failedTotal}` : ""}`
   ];

package/dist/index.cjs

@@ -9227,12 +9227,18 @@ function profileScreenshotLabels(viewports) {
   }
   return labels;
 }
-function profileSetupSummary(viewports, actionCount, expectedActionCountByViewport) {
+function profileSetupSummary(viewports, actionCount, expectedActionCountByViewport, finalScreenshotFullPage) {
+  const normalizedFinalScreenshotFullPage = finalScreenshotFullPage === void 0 ? void 0 : finalScreenshotFullPage !== false;
+  const finalScreenshotCount = viewports.filter((viewport) => typeof viewport.screenshot_label === "string" && viewport.screenshot_label.trim()).length;
   return toJsonValue({
     viewport_count: viewports.length,
     action_count: actionCount ?? null,
+    final_screenshot_count: finalScreenshotCount,
+    final_screenshot_full_page: normalizedFinalScreenshotFullPage ?? null,
+    final_screenshot_mode: normalizedFinalScreenshotFullPage === void 0 ? null : normalizedFinalScreenshotFullPage ? "full_page" : "viewport",
     viewports: viewports.map((viewport) => {
       const expectedActionCount = expectedActionCountByViewport?.get(viewport.name) ?? actionCount;
+      const viewportFinalScreenshotFullPage = typeof viewport.screenshot_full_page === "boolean" ? viewport.screenshot_full_page : normalizedFinalScreenshotFullPage;
       const results = viewport.setup_action_results || [];
       const failed = results.filter((result) => result.ok === false && result.optional !== true);
       const optionalFailed = results.filter((result) => result.ok === false && result.optional === true);
@@ -9272,6 +9278,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
         action_counts: profileSetupActionCounts(results),
         frame_action_count: results.filter((result) => result.frame_selector).length,
         frame_urls: profileSetupFrameUrls(viewport),
+        final_screenshot: viewport.screenshot_label ?? null,
+        final_screenshot_full_page: viewportFinalScreenshotFullPage ?? null,
         setup_screenshots: profileSetupScreenshotLabels(results),
         clicked_total: clickedItems.length,
         clicked_truncated: clickedItems.length > clicked.length,
@@ -9608,6 +9616,42 @@ function normalizeSetupActions(value) {
   if (!Array.isArray(value)) throw new Error("target.setup_actions must be an array.");
   return value.map(normalizeSetupAction);
 }
+function normalizeTargetScreenshotFullPage(input) {
+  const directFullPage = booleanValue(valueFromOwn(
+    input,
+    "screenshot_full_page",
+    "screenshotFullPage",
+    "final_screenshot_full_page",
+    "finalScreenshotFullPage",
+    "full_page_screenshots",
+    "fullPageScreenshots"
+  ));
+  const viewportOnly = booleanValue(valueFromOwn(
+    input,
+    "viewport_screenshots",
+    "viewportScreenshots",
+    "viewport_only_screenshots",
+    "viewportOnlyScreenshots"
+  ));
+  const modeInput = stringFromOwn(input, "screenshot_mode", "screenshotMode", "final_screenshot_mode", "finalScreenshotMode");
+  let modeFullPage;
+  if (modeInput) {
+    const mode = modeInput.trim().toLowerCase().replace(/[-\s]+/g, "_");
+    if (mode === "full_page" || mode === "fullpage" || mode === "page" || mode === "document") {
+      modeFullPage = true;
+    } else if (mode === "viewport" || mode === "view") {
+      modeFullPage = false;
+    } else {
+      throw new Error(`target.screenshot_mode ${modeInput} is not supported. Supported modes: full_page, viewport.`);
+    }
+  }
+  const values = [directFullPage, viewportOnly === void 0 ? void 0 : !viewportOnly, modeFullPage].filter((value) => value !== void 0);
+  if (!values.length) return void 0;
+  if (values.some((value) => value !== values[0])) {
+    throw new Error("target has conflicting screenshot full_page / viewport mode options.");
+  }
+  return values[0];
+}
 function normalizeNetworkMock(input, index) {
   if (!isRecord2(input)) throw new Error(`target.network_mocks[${index}] must be an object.`);
   const url = stringValue5(input.url) || stringValue5(input.glob) || stringValue5(input.pattern);
@@ -10176,6 +10220,7 @@ function normalizeRiddleProofProfile(input, options = {}) {
       timeout_sec: timeoutSecValue(targetInput.timeout_sec) ?? timeoutSecValue(targetInput.timeoutSec) ?? timeoutSecValue(targetInput.riddle_timeout_sec) ?? timeoutSecValue(targetInput.riddleTimeoutSec),
       wait_for_selector: stringValue5(targetInput.wait_for_selector) || stringValue5(targetInput.waitForSelector),
       wait_ms: numberValue3(targetInput.wait_ms) ?? numberValue3(targetInput.waitMs),
+      screenshot_full_page: normalizeTargetScreenshotFullPage(targetInput),
       setup_actions: normalizeSetupActions(targetInput.setup_actions ?? targetInput.setupActions),
       network_mocks: normalizeNetworkMocks(targetInput.network_mocks ?? targetInput.networkMocks)
     },
@@ -11479,7 +11524,7 @@ function assessSetupActionsFromEvidence(profile, evidence) {
         ok: (viewport.setup_action_results || []).length >= (expectedActionCountByViewport.get(viewport.name) ?? actionCount) && (viewport.setup_action_results || []).every((result) => result.ok !== false || result.optional === true),
         result_count: (viewport.setup_action_results || []).length
       })),
-      setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountByViewport),
+      setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountByViewport, profile.target.screenshot_full_page),
       failed
     },
     message: failed.length ? `Setup actions failed in ${failed.length} viewport action(s).` : void 0
@@ -12499,14 +12544,28 @@ function profileScreenshotLabels(viewports) {
   }
   return labels;
 }
-function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport) {
+function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport, finalScreenshotFullPage) {
+  const normalizedFinalScreenshotFullPage = finalScreenshotFullPage === undefined
+    ? undefined
+    : finalScreenshotFullPage !== false;
+  const finalScreenshotCount = (viewports || []).filter((viewport) => viewport && typeof viewport.screenshot_label === "string" && viewport.screenshot_label.trim()).length;
   return {
     viewport_count: (viewports || []).length,
     action_count: actionCount ?? null,
+    final_screenshot_count: finalScreenshotCount,
+    final_screenshot_full_page: normalizedFinalScreenshotFullPage ?? null,
+    final_screenshot_mode: normalizedFinalScreenshotFullPage === undefined
+      ? null
+      : normalizedFinalScreenshotFullPage
+        ? "full_page"
+        : "viewport",
     viewports: (viewports || []).map((viewport) => {
       const expectedActionCount = expectedActionCountsByViewport && expectedActionCountsByViewport[viewport.name] !== undefined
         ? expectedActionCountsByViewport[viewport.name]
         : actionCount;
+      const viewportFinalScreenshotFullPage = typeof viewport.screenshot_full_page === "boolean"
+        ? viewport.screenshot_full_page
+        : normalizedFinalScreenshotFullPage;
       const results = viewport.setup_action_results || [];
       const failed = results.filter((result) => result && result.ok === false && result.optional !== true);
       const optionalFailed = results.filter((result) => result && result.ok === false && result.optional === true);
@@ -12560,6 +12619,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         action_counts: profileSetupActionCounts(results),
         frame_action_count: results.filter((result) => result && result.frame_selector).length,
         frame_urls: profileSetupFrameUrls(viewport),
+        final_screenshot: viewport.screenshot_label || null,
+        final_screenshot_full_page: viewportFinalScreenshotFullPage ?? null,
         setup_screenshots: profileSetupScreenshotLabels(results),
         clicked_total: clickedItems.length,
         clicked_truncated: clickedItems.length > clicked.length,
@@ -12744,7 +12805,7 @@ function assessProfile(profile, evidence) {
             && (viewport.setup_action_results || []).every((result) => !result || result.ok !== false || result.optional === true),
           result_count: (viewport.setup_action_results || []).length,
         })),
-        setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport),
+        setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport, profile.target && profile.target.screenshot_full_page),
         failed,
       },
       message: failed.length ? "Setup actions failed in " + failed.length + " viewport action(s)." : undefined,
@@ -15622,8 +15683,14 @@ async function captureViewport(viewport) {
     }
   }
   const screenshotLabel = profileSlug + "-" + viewport.name;
+  let screenshotFullPage = null;
   try {
-    if (typeof saveScreenshot === "function") await saveScreenshot(screenshotLabel);
+    const screenshotOptions = {};
+    if (profile.target && profile.target.screenshot_full_page !== undefined) {
+      screenshotFullPage = profile.target.screenshot_full_page !== false;
+      screenshotOptions.fullPage = screenshotFullPage;
+    }
+    if (typeof saveScreenshot === "function") await saveScreenshot(screenshotLabel, screenshotOptions);
   } catch (error) {
     pageErrors.push({ message: "saveScreenshot failed: " + String(error && error.message ? error.message : error).slice(0, 500) });
   }
@@ -15690,6 +15757,7 @@ async function captureViewport(viewport) {
     route_inventory: routeInventory,
     setup_action_results: setupActionResults,
     screenshot_label: screenshotLabel,
+    screenshot_full_page: screenshotFullPage,
     navigation_error: navigationError,
     wait_error: waitError,
   };

package/dist/index.js

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

package/dist/profile.cjs

@@ -541,12 +541,18 @@ function profileScreenshotLabels(viewports) {
   }
   return labels;
 }
-function profileSetupSummary(viewports, actionCount, expectedActionCountByViewport) {
+function profileSetupSummary(viewports, actionCount, expectedActionCountByViewport, finalScreenshotFullPage) {
+  const normalizedFinalScreenshotFullPage = finalScreenshotFullPage === void 0 ? void 0 : finalScreenshotFullPage !== false;
+  const finalScreenshotCount = viewports.filter((viewport) => typeof viewport.screenshot_label === "string" && viewport.screenshot_label.trim()).length;
   return toJsonValue({
     viewport_count: viewports.length,
     action_count: actionCount ?? null,
+    final_screenshot_count: finalScreenshotCount,
+    final_screenshot_full_page: normalizedFinalScreenshotFullPage ?? null,
+    final_screenshot_mode: normalizedFinalScreenshotFullPage === void 0 ? null : normalizedFinalScreenshotFullPage ? "full_page" : "viewport",
     viewports: viewports.map((viewport) => {
       const expectedActionCount = expectedActionCountByViewport?.get(viewport.name) ?? actionCount;
+      const viewportFinalScreenshotFullPage = typeof viewport.screenshot_full_page === "boolean" ? viewport.screenshot_full_page : normalizedFinalScreenshotFullPage;
       const results = viewport.setup_action_results || [];
       const failed = results.filter((result) => result.ok === false && result.optional !== true);
       const optionalFailed = results.filter((result) => result.ok === false && result.optional === true);
@@ -586,6 +592,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
         action_counts: profileSetupActionCounts(results),
         frame_action_count: results.filter((result) => result.frame_selector).length,
         frame_urls: profileSetupFrameUrls(viewport),
+        final_screenshot: viewport.screenshot_label ?? null,
+        final_screenshot_full_page: viewportFinalScreenshotFullPage ?? null,
         setup_screenshots: profileSetupScreenshotLabels(results),
         clicked_total: clickedItems.length,
         clicked_truncated: clickedItems.length > clicked.length,
@@ -922,6 +930,42 @@ function normalizeSetupActions(value) {
   if (!Array.isArray(value)) throw new Error("target.setup_actions must be an array.");
   return value.map(normalizeSetupAction);
 }
+function normalizeTargetScreenshotFullPage(input) {
+  const directFullPage = booleanValue(valueFromOwn(
+    input,
+    "screenshot_full_page",
+    "screenshotFullPage",
+    "final_screenshot_full_page",
+    "finalScreenshotFullPage",
+    "full_page_screenshots",
+    "fullPageScreenshots"
+  ));
+  const viewportOnly = booleanValue(valueFromOwn(
+    input,
+    "viewport_screenshots",
+    "viewportScreenshots",
+    "viewport_only_screenshots",
+    "viewportOnlyScreenshots"
+  ));
+  const modeInput = stringFromOwn(input, "screenshot_mode", "screenshotMode", "final_screenshot_mode", "finalScreenshotMode");
+  let modeFullPage;
+  if (modeInput) {
+    const mode = modeInput.trim().toLowerCase().replace(/[-\s]+/g, "_");
+    if (mode === "full_page" || mode === "fullpage" || mode === "page" || mode === "document") {
+      modeFullPage = true;
+    } else if (mode === "viewport" || mode === "view") {
+      modeFullPage = false;
+    } else {
+      throw new Error(`target.screenshot_mode ${modeInput} is not supported. Supported modes: full_page, viewport.`);
+    }
+  }
+  const values = [directFullPage, viewportOnly === void 0 ? void 0 : !viewportOnly, modeFullPage].filter((value) => value !== void 0);
+  if (!values.length) return void 0;
+  if (values.some((value) => value !== values[0])) {
+    throw new Error("target has conflicting screenshot full_page / viewport mode options.");
+  }
+  return values[0];
+}
 function normalizeNetworkMock(input, index) {
   if (!isRecord(input)) throw new Error(`target.network_mocks[${index}] must be an object.`);
   const url = stringValue(input.url) || stringValue(input.glob) || stringValue(input.pattern);
@@ -1490,6 +1534,7 @@ function normalizeRiddleProofProfile(input, options = {}) {
       timeout_sec: timeoutSecValue(targetInput.timeout_sec) ?? timeoutSecValue(targetInput.timeoutSec) ?? timeoutSecValue(targetInput.riddle_timeout_sec) ?? timeoutSecValue(targetInput.riddleTimeoutSec),
       wait_for_selector: stringValue(targetInput.wait_for_selector) || stringValue(targetInput.waitForSelector),
       wait_ms: numberValue(targetInput.wait_ms) ?? numberValue(targetInput.waitMs),
+      screenshot_full_page: normalizeTargetScreenshotFullPage(targetInput),
       setup_actions: normalizeSetupActions(targetInput.setup_actions ?? targetInput.setupActions),
       network_mocks: normalizeNetworkMocks(targetInput.network_mocks ?? targetInput.networkMocks)
     },
@@ -2793,7 +2838,7 @@ function assessSetupActionsFromEvidence(profile, evidence) {
         ok: (viewport.setup_action_results || []).length >= (expectedActionCountByViewport.get(viewport.name) ?? actionCount) && (viewport.setup_action_results || []).every((result) => result.ok !== false || result.optional === true),
         result_count: (viewport.setup_action_results || []).length
       })),
-      setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountByViewport),
+      setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountByViewport, profile.target.screenshot_full_page),
       failed
     },
     message: failed.length ? `Setup actions failed in ${failed.length} viewport action(s).` : void 0
@@ -3813,14 +3858,28 @@ function profileScreenshotLabels(viewports) {
   }
   return labels;
 }
-function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport) {
+function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport, finalScreenshotFullPage) {
+  const normalizedFinalScreenshotFullPage = finalScreenshotFullPage === undefined
+    ? undefined
+    : finalScreenshotFullPage !== false;
+  const finalScreenshotCount = (viewports || []).filter((viewport) => viewport && typeof viewport.screenshot_label === "string" && viewport.screenshot_label.trim()).length;
   return {
     viewport_count: (viewports || []).length,
     action_count: actionCount ?? null,
+    final_screenshot_count: finalScreenshotCount,
+    final_screenshot_full_page: normalizedFinalScreenshotFullPage ?? null,
+    final_screenshot_mode: normalizedFinalScreenshotFullPage === undefined
+      ? null
+      : normalizedFinalScreenshotFullPage
+        ? "full_page"
+        : "viewport",
     viewports: (viewports || []).map((viewport) => {
       const expectedActionCount = expectedActionCountsByViewport && expectedActionCountsByViewport[viewport.name] !== undefined
         ? expectedActionCountsByViewport[viewport.name]
         : actionCount;
+      const viewportFinalScreenshotFullPage = typeof viewport.screenshot_full_page === "boolean"
+        ? viewport.screenshot_full_page
+        : normalizedFinalScreenshotFullPage;
       const results = viewport.setup_action_results || [];
       const failed = results.filter((result) => result && result.ok === false && result.optional !== true);
       const optionalFailed = results.filter((result) => result && result.ok === false && result.optional === true);
@@ -3874,6 +3933,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         action_counts: profileSetupActionCounts(results),
         frame_action_count: results.filter((result) => result && result.frame_selector).length,
         frame_urls: profileSetupFrameUrls(viewport),
+        final_screenshot: viewport.screenshot_label || null,
+        final_screenshot_full_page: viewportFinalScreenshotFullPage ?? null,
         setup_screenshots: profileSetupScreenshotLabels(results),
         clicked_total: clickedItems.length,
         clicked_truncated: clickedItems.length > clicked.length,
@@ -4058,7 +4119,7 @@ function assessProfile(profile, evidence) {
             && (viewport.setup_action_results || []).every((result) => !result || result.ok !== false || result.optional === true),
           result_count: (viewport.setup_action_results || []).length,
         })),
-        setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport),
+        setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport, profile.target && profile.target.screenshot_full_page),
         failed,
       },
       message: failed.length ? "Setup actions failed in " + failed.length + " viewport action(s)." : undefined,
@@ -6936,8 +6997,14 @@ async function captureViewport(viewport) {
     }
   }
   const screenshotLabel = profileSlug + "-" + viewport.name;
+  let screenshotFullPage = null;
   try {
-    if (typeof saveScreenshot === "function") await saveScreenshot(screenshotLabel);
+    const screenshotOptions = {};
+    if (profile.target && profile.target.screenshot_full_page !== undefined) {
+      screenshotFullPage = profile.target.screenshot_full_page !== false;
+      screenshotOptions.fullPage = screenshotFullPage;
+    }
+    if (typeof saveScreenshot === "function") await saveScreenshot(screenshotLabel, screenshotOptions);
   } catch (error) {
     pageErrors.push({ message: "saveScreenshot failed: " + String(error && error.message ? error.message : error).slice(0, 500) });
   }
@@ -7004,6 +7071,7 @@ async function captureViewport(viewport) {
     route_inventory: routeInventory,
     setup_action_results: setupActionResults,
     screenshot_label: screenshotLabel,
+    screenshot_full_page: screenshotFullPage,
     navigation_error: navigationError,
     wait_error: waitError,
   };

package/dist/profile.d.cts

@@ -203,6 +203,7 @@ interface RiddleProofProfileTarget {
     timeout_sec?: number;
     wait_for_selector?: string;
     wait_ms?: number;
+    screenshot_full_page?: boolean;
     setup_actions?: RiddleProofProfileSetupAction[];
     network_mocks?: RiddleProofProfileNetworkMock[];
 }
@@ -322,6 +323,7 @@ interface RiddleProofProfileViewportEvidence {
     route_inventory?: Record<string, JsonValue>;
     setup_action_results?: Array<Record<string, JsonValue>>;
     screenshot_label?: string;
+    screenshot_full_page?: boolean | null;
     navigation_error?: string;
     wait_error?: string;
 }

package/dist/profile.d.ts

@@ -203,6 +203,7 @@ interface RiddleProofProfileTarget {
     timeout_sec?: number;
     wait_for_selector?: string;
     wait_ms?: number;
+    screenshot_full_page?: boolean;
     setup_actions?: RiddleProofProfileSetupAction[];
     network_mocks?: RiddleProofProfileNetworkMock[];
 }
@@ -322,6 +323,7 @@ interface RiddleProofProfileViewportEvidence {
     route_inventory?: Record<string, JsonValue>;
     setup_action_results?: Array<Record<string, JsonValue>>;
     screenshot_label?: string;
+    screenshot_full_page?: boolean | null;
     navigation_error?: string;
     wait_error?: string;
 }

package/dist/profile.js

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