@riddledc/riddle-proof 0.7.137 → 0.7.139

package/README.md

@@ -455,7 +455,10 @@ met and records `call_count`, final `returned`, and final `until_value`.
 Use `screenshot` with an optional `label` to capture durable Riddle screenshots
 at important setup milestones, such as after a route switch, terminal state, or
 reset. These labels are recorded in setup evidence and included in profile
-artifact summaries alongside final viewport screenshots.
+artifact summaries alongside final viewport screenshots. Setup screenshots are
+full-page by default; set `full_page: false`, `fullPage: false`, or
+`mode: "viewport"` when fixed or sticky page chrome would make full-page
+captures harder to review.
 Add `frame_selector` / `frameSelector` to a setup action when the interaction
 target lives inside an embedded iframe, such as a community game player or
 hosted preview surface. Selector-based actions, storage actions, window calls,
@@ -479,6 +482,12 @@ 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.
+
 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-2WWSWSYA.js → chunk-DB6J53V5.js}

@@ -665,6 +665,34 @@ function normalizeSetupActionPointerType(value, type, index) {
   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 normalizeSetupActionScreenshotFullPage(input, type, index) {
+  const directFullPage = booleanValue(valueFromOwn(input, "full_page", "fullPage"));
+  const viewportOnly = booleanValue(valueFromOwn(input, "viewport_only", "viewportOnly", "viewport_screenshot", "viewportScreenshot"));
+  if (type !== "screenshot") {
+    if (directFullPage !== void 0 || viewportOnly !== void 0 || valueFromOwn(input, "screenshot_mode", "screenshotMode", "capture_mode", "captureMode") !== void 0) {
+      throw new Error(`target.setup_actions[${index}].full_page is only supported for screenshot actions.`);
+    }
+    return void 0;
+  }
+  const modeInput = stringFromOwn(input, "mode", "screenshot_mode", "screenshotMode", "capture_mode", "captureMode");
+  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.setup_actions[${index}].mode ${modeInput} is not supported for screenshot actions. 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.setup_actions[${index}] has conflicting screenshot full_page / viewport mode options.`);
+  }
+  return values[0];
+}
 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);
@@ -795,6 +823,7 @@ function normalizeSetupAction(input, index) {
     selector,
     frame_selector: frameSelector,
     frame_index: frameIndex,
+    full_page: normalizeSetupActionScreenshotFullPage(input, type, index),
     force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
     click_count: normalizeSetupActionClickCount(input, type, index),
     coordinate_mode: coordinateMode,
@@ -846,6 +875,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);
@@ -1414,6 +1479,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)
     },
@@ -5104,8 +5170,10 @@ async function executeSetupAction(action, ordinal, viewport) {
       const viewportName = viewport && viewport.name ? viewport.name : "viewport";
       const label = profileSlug + "-" + viewportName + "-" + labelPart;
       if (typeof saveScreenshot !== "function") return { ...base, reason: "save_screenshot_unavailable", label: rawLabel };
-      await saveScreenshot(label);
-      return { ...base, ok: true, label: rawLabel, screenshot_label: label };
+      const screenshotOptions = {};
+      if (action.full_page !== undefined) screenshotOptions.fullPage = action.full_page !== false;
+      await saveScreenshot(label, screenshotOptions);
+      return { ...base, ok: true, label: rawLabel, screenshot_label: label, full_page: action.full_page === undefined ? null : action.full_page !== false };
     }
     if (type === "clear_console") {
       const cleared_console_event_count = consoleEvents.length;
@@ -6859,7 +6927,9 @@ async function captureViewport(viewport) {
   }
   const screenshotLabel = profileSlug + "-" + viewport.name;
   try {
-    if (typeof saveScreenshot === "function") await saveScreenshot(screenshotLabel);
+    const screenshotOptions = {};
+    if (profile.target && profile.target.screenshot_full_page !== undefined) screenshotOptions.fullPage = profile.target.screenshot_full_page !== false;
+    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) });
   }

package/dist/cli.cjs

@@ -7602,6 +7602,34 @@ function normalizeSetupActionPointerType(value, type, index) {
   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 normalizeSetupActionScreenshotFullPage(input, type, index) {
+  const directFullPage = booleanValue(valueFromOwn(input, "full_page", "fullPage"));
+  const viewportOnly = booleanValue(valueFromOwn(input, "viewport_only", "viewportOnly", "viewport_screenshot", "viewportScreenshot"));
+  if (type !== "screenshot") {
+    if (directFullPage !== void 0 || viewportOnly !== void 0 || valueFromOwn(input, "screenshot_mode", "screenshotMode", "capture_mode", "captureMode") !== void 0) {
+      throw new Error(`target.setup_actions[${index}].full_page is only supported for screenshot actions.`);
+    }
+    return void 0;
+  }
+  const modeInput = stringFromOwn(input, "mode", "screenshot_mode", "screenshotMode", "capture_mode", "captureMode");
+  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.setup_actions[${index}].mode ${modeInput} is not supported for screenshot actions. 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.setup_actions[${index}] has conflicting screenshot full_page / viewport mode options.`);
+  }
+  return values[0];
+}
 function normalizeSetupAction(input, index) {
   if (!isRecord(input)) throw new Error(`target.setup_actions[${index}] must be an object.`);
   const type = normalizeSetupActionType(stringValue2(input.type), index);
@@ -7732,6 +7760,7 @@ function normalizeSetupAction(input, index) {
     selector,
     frame_selector: frameSelector,
     frame_index: frameIndex,
+    full_page: normalizeSetupActionScreenshotFullPage(input, type, index),
     force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
     click_count: normalizeSetupActionClickCount(input, type, index),
     coordinate_mode: coordinateMode,
@@ -7783,6 +7812,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);
@@ -8351,6 +8416,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)
     },
@@ -12025,8 +12091,10 @@ async function executeSetupAction(action, ordinal, viewport) {
       const viewportName = viewport && viewport.name ? viewport.name : "viewport";
       const label = profileSlug + "-" + viewportName + "-" + labelPart;
       if (typeof saveScreenshot !== "function") return { ...base, reason: "save_screenshot_unavailable", label: rawLabel };
-      await saveScreenshot(label);
-      return { ...base, ok: true, label: rawLabel, screenshot_label: label };
+      const screenshotOptions = {};
+      if (action.full_page !== undefined) screenshotOptions.fullPage = action.full_page !== false;
+      await saveScreenshot(label, screenshotOptions);
+      return { ...base, ok: true, label: rawLabel, screenshot_label: label, full_page: action.full_page === undefined ? null : action.full_page !== false };
     }
     if (type === "clear_console") {
       const cleared_console_event_count = consoleEvents.length;
@@ -13780,7 +13848,9 @@ async function captureViewport(viewport) {
   }
   const screenshotLabel = profileSlug + "-" + viewport.name;
   try {
-    if (typeof saveScreenshot === "function") await saveScreenshot(screenshotLabel);
+    const screenshotOptions = {};
+    if (profile.target && profile.target.screenshot_full_page !== undefined) screenshotOptions.fullPage = profile.target.screenshot_full_page !== false;
+    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) });
   }

package/dist/cli.js

@@ -12,7 +12,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-2WWSWSYA.js";
+} from "./chunk-DB6J53V5.js";
 import {
   createRiddleApiClient,
   parseRiddleViewport

package/dist/index.cjs

@@ -9398,6 +9398,34 @@ function normalizeSetupActionPointerType(value, type, index) {
   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 normalizeSetupActionScreenshotFullPage(input, type, index) {
+  const directFullPage = booleanValue(valueFromOwn(input, "full_page", "fullPage"));
+  const viewportOnly = booleanValue(valueFromOwn(input, "viewport_only", "viewportOnly", "viewport_screenshot", "viewportScreenshot"));
+  if (type !== "screenshot") {
+    if (directFullPage !== void 0 || viewportOnly !== void 0 || valueFromOwn(input, "screenshot_mode", "screenshotMode", "capture_mode", "captureMode") !== void 0) {
+      throw new Error(`target.setup_actions[${index}].full_page is only supported for screenshot actions.`);
+    }
+    return void 0;
+  }
+  const modeInput = stringFromOwn(input, "mode", "screenshot_mode", "screenshotMode", "capture_mode", "captureMode");
+  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.setup_actions[${index}].mode ${modeInput} is not supported for screenshot actions. 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.setup_actions[${index}] has conflicting screenshot full_page / viewport mode options.`);
+  }
+  return values[0];
+}
 function normalizeSetupAction(input, index) {
   if (!isRecord2(input)) throw new Error(`target.setup_actions[${index}] must be an object.`);
   const type = normalizeSetupActionType(stringValue5(input.type), index);
@@ -9528,6 +9556,7 @@ function normalizeSetupAction(input, index) {
     selector,
     frame_selector: frameSelector,
     frame_index: frameIndex,
+    full_page: normalizeSetupActionScreenshotFullPage(input, type, index),
     force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
     click_count: normalizeSetupActionClickCount(input, type, index),
     coordinate_mode: coordinateMode,
@@ -9579,6 +9608,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);
@@ -10147,6 +10212,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)
     },
@@ -13837,8 +13903,10 @@ async function executeSetupAction(action, ordinal, viewport) {
       const viewportName = viewport && viewport.name ? viewport.name : "viewport";
       const label = profileSlug + "-" + viewportName + "-" + labelPart;
       if (typeof saveScreenshot !== "function") return { ...base, reason: "save_screenshot_unavailable", label: rawLabel };
-      await saveScreenshot(label);
-      return { ...base, ok: true, label: rawLabel, screenshot_label: label };
+      const screenshotOptions = {};
+      if (action.full_page !== undefined) screenshotOptions.fullPage = action.full_page !== false;
+      await saveScreenshot(label, screenshotOptions);
+      return { ...base, ok: true, label: rawLabel, screenshot_label: label, full_page: action.full_page === undefined ? null : action.full_page !== false };
     }
     if (type === "clear_console") {
       const cleared_console_event_count = consoleEvents.length;
@@ -15592,7 +15660,9 @@ async function captureViewport(viewport) {
   }
   const screenshotLabel = profileSlug + "-" + viewport.name;
   try {
-    if (typeof saveScreenshot === "function") await saveScreenshot(screenshotLabel);
+    const screenshotOptions = {};
+    if (profile.target && profile.target.screenshot_full_page !== undefined) screenshotOptions.fullPage = profile.target.screenshot_full_page !== false;
+    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) });
   }

package/dist/index.js

@@ -62,7 +62,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-2WWSWSYA.js";
+} from "./chunk-DB6J53V5.js";
 import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,

package/dist/profile.cjs

@@ -712,6 +712,34 @@ function normalizeSetupActionPointerType(value, type, index) {
   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 normalizeSetupActionScreenshotFullPage(input, type, index) {
+  const directFullPage = booleanValue(valueFromOwn(input, "full_page", "fullPage"));
+  const viewportOnly = booleanValue(valueFromOwn(input, "viewport_only", "viewportOnly", "viewport_screenshot", "viewportScreenshot"));
+  if (type !== "screenshot") {
+    if (directFullPage !== void 0 || viewportOnly !== void 0 || valueFromOwn(input, "screenshot_mode", "screenshotMode", "capture_mode", "captureMode") !== void 0) {
+      throw new Error(`target.setup_actions[${index}].full_page is only supported for screenshot actions.`);
+    }
+    return void 0;
+  }
+  const modeInput = stringFromOwn(input, "mode", "screenshot_mode", "screenshotMode", "capture_mode", "captureMode");
+  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.setup_actions[${index}].mode ${modeInput} is not supported for screenshot actions. 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.setup_actions[${index}] has conflicting screenshot full_page / viewport mode options.`);
+  }
+  return values[0];
+}
 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);
@@ -842,6 +870,7 @@ function normalizeSetupAction(input, index) {
     selector,
     frame_selector: frameSelector,
     frame_index: frameIndex,
+    full_page: normalizeSetupActionScreenshotFullPage(input, type, index),
     force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
     click_count: normalizeSetupActionClickCount(input, type, index),
     coordinate_mode: coordinateMode,
@@ -893,6 +922,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);
@@ -1461,6 +1526,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)
     },
@@ -5151,8 +5217,10 @@ async function executeSetupAction(action, ordinal, viewport) {
       const viewportName = viewport && viewport.name ? viewport.name : "viewport";
       const label = profileSlug + "-" + viewportName + "-" + labelPart;
       if (typeof saveScreenshot !== "function") return { ...base, reason: "save_screenshot_unavailable", label: rawLabel };
-      await saveScreenshot(label);
-      return { ...base, ok: true, label: rawLabel, screenshot_label: label };
+      const screenshotOptions = {};
+      if (action.full_page !== undefined) screenshotOptions.fullPage = action.full_page !== false;
+      await saveScreenshot(label, screenshotOptions);
+      return { ...base, ok: true, label: rawLabel, screenshot_label: label, full_page: action.full_page === undefined ? null : action.full_page !== false };
     }
     if (type === "clear_console") {
       const cleared_console_event_count = consoleEvents.length;
@@ -6906,7 +6974,9 @@ async function captureViewport(viewport) {
   }
   const screenshotLabel = profileSlug + "-" + viewport.name;
   try {
-    if (typeof saveScreenshot === "function") await saveScreenshot(screenshotLabel);
+    const screenshotOptions = {};
+    if (profile.target && profile.target.screenshot_full_page !== undefined) screenshotOptions.fullPage = profile.target.screenshot_full_page !== false;
+    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) });
   }

package/dist/profile.d.cts

@@ -112,6 +112,7 @@ interface RiddleProofProfileSetupAction {
     selector?: string;
     frame_selector?: string;
     frame_index?: number;
+    full_page?: boolean;
     force?: boolean;
     click_count?: number;
     coordinate_mode?: "pixels" | "ratio";
@@ -202,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[];
 }

package/dist/profile.d.ts

@@ -112,6 +112,7 @@ interface RiddleProofProfileSetupAction {
     selector?: string;
     frame_selector?: string;
     frame_index?: number;
+    full_page?: boolean;
     force?: boolean;
     click_count?: number;
     coordinate_mode?: "pixels" | "ratio";
@@ -202,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[];
 }

package/dist/profile.js

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