@riddledc/riddle-proof 0.7.137 → 0.7.138

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,

package/dist/{chunk-2WWSWSYA.js → chunk-N75EAJNG.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,
@@ -5104,8 +5133,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;

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,
@@ -12025,8 +12054,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;

package/dist/cli.js

@@ -12,7 +12,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-2WWSWSYA.js";
+} from "./chunk-N75EAJNG.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,
@@ -13837,8 +13866,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;

package/dist/index.js

@@ -62,7 +62,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-2WWSWSYA.js";
+} from "./chunk-N75EAJNG.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,
@@ -5151,8 +5180,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;

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";

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";

package/dist/profile.js

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