@riddledc/riddle-proof 0.7.134 → 0.7.136

package/dist/{chunk-TALHK3NV.js → chunk-DNSJMFK6.js}

@@ -732,6 +732,18 @@ function normalizeSetupAction(input, index) {
     }
   }
   const hasExpectedReturn = hasOwn(input, "expect_return") || hasOwn(input, "expectReturn") || hasOwn(input, "expected_return") || hasOwn(input, "expectedReturn");
+  const storeReturnTo = stringFromOwn(
+    input,
+    "store_return_to",
+    "storeReturnTo",
+    "save_return_to",
+    "saveReturnTo",
+    "assign_return_to",
+    "assignReturnTo",
+    "return_state_path",
+    "returnStatePath"
+  );
+  const captureReturn = input.capture_return === false || input.captureReturn === false || input.include_return === false || input.includeReturn === false || input.omit_return === true || input.omitReturn === true ? false : void 0;
   const untilPath = stringFromOwn(input, "until_path", "untilPath", "until_state_path", "untilStatePath", "until_window_path", "untilWindowPath", "until");
   const hasUntilExpectedValue = hasOwn(input, "until_expected_value") || hasOwn(input, "untilExpectedValue") || hasOwn(input, "until_expected") || hasOwn(input, "untilExpected") || hasOwn(input, "until_value") || hasOwn(input, "untilValue") || hasOwn(input, "expected_value") || hasOwn(input, "expectedValue") || hasOwn(input, "expected");
   if (type === "window_call_until") {
@@ -776,6 +788,8 @@ function normalizeSetupAction(input, index) {
     path,
     args,
     expect_return: hasExpectedReturn ? toJsonValue(valueFromOwn(input, "expect_return", "expectReturn", "expected_return", "expectedReturn")) : void 0,
+    store_return_to: storeReturnTo,
+    capture_return: captureReturn,
     until_path: untilPath,
     until_expected_value: hasUntilExpectedValue ? toJsonValue(valueFromOwn(input, "until_expected_value", "untilExpectedValue", "until_expected", "untilExpected", "until_value", "untilValue", "expected_value", "expectedValue", "expected")) : void 0,
     max_calls: maxCalls,
@@ -3653,6 +3667,21 @@ function profileSetupScreenshotLabels(results) {
     .map((result) => result.screenshot_label)
     .filter(Boolean);
 }
+function profileSetupWindowCallUntilReceipts(results) {
+  return (results || [])
+    .filter((result) => result && profileSetupResultAction(result) === "window_call_until")
+    .map((result) => ({
+      ordinal: result.ordinal ?? null,
+      ok: result.ok !== false,
+      path: result.path ?? null,
+      until_path: result.until_path ?? null,
+      until_value: result.until_value ?? null,
+      until_expected_value: result.until_expected_value ?? null,
+      call_count: result.call_count ?? null,
+      max_calls: result.max_calls ?? null,
+      reason: result.reason || result.error || null,
+    }));
+}
 function sampleProfileSetupSummaryItems(items, limit) {
   if ((items || []).length <= limit) return items || [];
   const firstCount = Math.floor(limit / 2);
@@ -3682,6 +3711,11 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
       const clickCountValues = successfulClicks
         .map((result) => typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : undefined)
         .filter((value) => value !== undefined);
+      const windowCallUntilReceipts = profileSetupWindowCallUntilReceipts(results);
+      const windowCallUntilCallCounts = windowCallUntilReceipts
+        .map((result) => typeof result.call_count === "number" && Number.isFinite(result.call_count) ? result.call_count : undefined)
+        .filter((value) => value !== undefined);
+      const sampledWindowCallUntilReceipts = sampleProfileSetupSummaryItems(windowCallUntilReceipts, 8);
       const clickedItems = results
         .filter((result) => result && profileSetupResultAction(result) === "click" && result.ok !== false)
         .map((result) => {
@@ -3724,6 +3758,10 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         clicked_truncated: clickedItems.length > clicked.length,
         click_count_action_total: clickCountValues.length,
         click_count_value_total: clickCountValues.reduce((sum, value) => sum + value, 0),
+        window_call_until_total: windowCallUntilReceipts.length,
+        window_call_until_call_total: windowCallUntilCallCounts.reduce((sum, value) => sum + value, 0),
+        window_call_until_truncated: windowCallUntilReceipts.length > sampledWindowCallUntilReceipts.length,
+        window_call_until: sampledWindowCallUntilReceipts,
         clicked,
         text_samples: textSamples,
         failed: failed.map((result) => ({
@@ -4656,8 +4694,8 @@ async function setupReadWindowValue(context, path) {
     return { ok: true, value: toJsonValue(current) };
   }, { path });
 }
-async function setupCallWindowFunction(context, path, args) {
-  return await context.evaluate(async ({ path, args }) => {
+async function setupCallWindowFunction(context, path, args, storeReturnTo, captureReturn) {
+  return await context.evaluate(async ({ path, args, storeReturnTo, captureReturn }) => {
     const toJsonValue = (value) => {
       if (value === null || value === undefined) return null;
       if (typeof value === "string" || typeof value === "boolean") return value;
@@ -4668,6 +4706,19 @@ async function setupCallWindowFunction(context, path, args) {
       }
       return String(value);
     };
+    const storeWindowReturn = (storePath, value) => {
+      const pathParts = String(storePath || "").split(".").map((part) => part.trim()).filter(Boolean);
+      if (pathParts[0] === "window") pathParts.shift();
+      if (!pathParts.length) return { ok: false, reason: "missing_store_path" };
+      let target = window;
+      for (let index = 0; index < pathParts.length - 1; index += 1) {
+        const part = pathParts[index];
+        if (target[part] === null || typeof target[part] !== "object") target[part] = {};
+        target = target[part];
+      }
+      target[pathParts[pathParts.length - 1]] = value;
+      return { ok: true, path: pathParts.join(".") };
+    };
     const pathParts = String(path || "").split(".").map((part) => part.trim()).filter(Boolean);
     let parent = window;
     let current = window;
@@ -4678,11 +4729,18 @@ async function setupCallWindowFunction(context, path, args) {
     if (typeof current !== "function") return { ok: false, reason: "missing_function" };
     try {
       const returned = await current.apply(parent, Array.isArray(args) ? args : []);
-      return { ok: true, returned: toJsonValue(returned) };
+      const jsonReturned = toJsonValue(returned);
+      const returnedForResult = captureReturn === false ? undefined : jsonReturned;
+      if (storeReturnTo) {
+        const stored = storeWindowReturn(storeReturnTo, jsonReturned);
+        if (!stored.ok) return { ok: false, reason: "return_store_failed", store_reason: stored.reason, returned: returnedForResult };
+        return { ok: true, returned: returnedForResult, return_stored_to: stored.path };
+      }
+      return { ok: true, returned: returnedForResult };
     } catch (error) {
       return { ok: false, reason: "function_threw", error: String(error && error.message ? error.message : error).slice(0, 1000) };
     }
-  }, { path, args });
+  }, { path, args, storeReturnTo, captureReturn });
 }
 function setupFrameSelector(action) {
   return String(action?.frame_selector || action?.frameSelector || action?.iframe_selector || action?.iframeSelector || "").trim();
@@ -5198,10 +5256,10 @@ async function executeSetupAction(action, ordinal, viewport) {
     if (type === "window_call") {
       const path = String(action.path || action.function_path || action.functionPath || "");
       const args = Array.isArray(action.args) ? action.args : [];
+      const storeReturnTo = String(action.store_return_to || action.storeReturnTo || action.save_return_to || action.saveReturnTo || action.assign_return_to || action.assignReturnTo || action.return_state_path || action.returnStatePath || "").trim();
       if (!path) return { ...base, path, reason: "missing_path" };
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
-      const result = await setupCallWindowFunction(scope.context, path, args);
       const hasExpectation = setupHasOwn(action, "expect_return")
         || setupHasOwn(action, "expectReturn")
         || setupHasOwn(action, "expected_return")
@@ -5210,9 +5268,13 @@ async function executeSetupAction(action, ordinal, viewport) {
         ? action.expect_return
         : setupHasOwn(action, "expectReturn")
           ? action.expectReturn
-          : setupHasOwn(action, "expected_return")
-            ? action.expected_return
-            : action.expectedReturn;
+        : setupHasOwn(action, "expected_return")
+          ? action.expected_return
+          : action.expectedReturn;
+      const captureReturn = action.capture_return === false || action.captureReturn === false || action.include_return === false || action.includeReturn === false || action.omit_return === true || action.omitReturn === true
+        ? hasExpectation
+        : true;
+      const result = await setupCallWindowFunction(scope.context, path, args, storeReturnTo, captureReturn);
       const expectationMet = !hasExpectation || setupValuesEqual(result.returned, expected);
       return {
         ...base,
@@ -5220,9 +5282,12 @@ async function executeSetupAction(action, ordinal, viewport) {
         ok: Boolean(result.ok && expectationMet),
         path,
         arg_count: args.length,
-        returned: setupJsonValue(result.returned),
+        returned: captureReturn ? setupJsonValue(result.returned) : undefined,
+        return_captured: captureReturn,
         expected_return: hasExpectation ? setupJsonValue(expected) : undefined,
+        return_stored_to: result.return_stored_to || storeReturnTo || undefined,
         reason: result.ok ? (expectationMet ? undefined : "unexpected_return_value") : result.reason,
+        store_reason: result.store_reason || undefined,
         error: result.error || undefined,
       };
     }
@@ -5230,6 +5295,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       const path = String(action.path || action.function_path || action.functionPath || "");
       const untilPath = String(action.until_path || action.untilPath || action.until_state_path || action.untilStatePath || action.until_window_path || action.untilWindowPath || action.until || "");
       const args = Array.isArray(action.args) ? action.args : [];
+      const storeReturnTo = String(action.store_return_to || action.storeReturnTo || action.save_return_to || action.saveReturnTo || action.assign_return_to || action.assignReturnTo || action.return_state_path || action.returnStatePath || "").trim();
       if (!path) return { ...base, path, reason: "missing_path" };
       if (!untilPath) return { ...base, path, reason: "missing_until_path" };
       const hasUntilExpected = setupHasOwn(action, "until_expected_value")
@@ -5272,6 +5338,9 @@ async function executeSetupAction(action, ordinal, viewport) {
           : setupHasOwn(action, "expected_return")
             ? action.expected_return
             : action.expectedReturn;
+      const captureReturn = action.capture_return === false || action.captureReturn === false || action.include_return === false || action.includeReturn === false || action.omit_return === true || action.omitReturn === true
+        ? hasReturnExpectation
+        : true;
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
       const startedAt = Date.now();
@@ -5295,7 +5364,7 @@ async function executeSetupAction(action, ordinal, viewport) {
         };
       }
       while (callCount < maxCalls && Date.now() - startedAt <= timeout) {
-        lastCallResult = await setupCallWindowFunction(scope.context, path, args);
+        lastCallResult = await setupCallWindowFunction(scope.context, path, args, storeReturnTo, captureReturn);
         callCount += 1;
         if (!lastCallResult.ok) break;
         if (hasReturnExpectation && !setupValuesEqual(lastCallResult.returned, expectedReturn)) break;
@@ -5307,8 +5376,10 @@ async function executeSetupAction(action, ordinal, viewport) {
             ok: true,
             path,
             arg_count: args.length,
-            returned: setupJsonValue(lastCallResult.returned),
+            returned: captureReturn ? setupJsonValue(lastCallResult.returned) : undefined,
+            return_captured: captureReturn,
             expected_return: hasReturnExpectation ? setupJsonValue(expectedReturn) : undefined,
+            return_stored_to: lastCallResult.return_stored_to || storeReturnTo || undefined,
             until_path: untilPath,
             until_value: setupJsonValue(lastPredicateResult.value),
             until_expected_value: setupJsonValue(untilExpected),
@@ -5326,8 +5397,10 @@ async function executeSetupAction(action, ordinal, viewport) {
         ...setupScopeEvidence(scope),
         path,
         arg_count: args.length,
-        returned: setupJsonValue(lastCallResult?.returned),
+        returned: captureReturn ? setupJsonValue(lastCallResult?.returned) : undefined,
+        return_captured: captureReturn,
         expected_return: hasReturnExpectation ? setupJsonValue(expectedReturn) : undefined,
+        return_stored_to: lastCallResult?.return_stored_to || storeReturnTo || undefined,
         until_path: untilPath,
         until_value: setupJsonValue(lastPredicateResult?.value),
         until_expected_value: setupJsonValue(untilExpected),
@@ -5343,6 +5416,7 @@ async function executeSetupAction(action, ordinal, viewport) {
               ? "timeout"
               : "until_condition_not_met",
         error: lastCallResult?.error || undefined,
+        store_reason: lastCallResult?.store_reason || undefined,
         missing_part: lastPredicateResult?.missing_part || undefined,
       };
     }

package/dist/cli.cjs

@@ -7669,6 +7669,18 @@ function normalizeSetupAction(input, index) {
     }
   }
   const hasExpectedReturn = hasOwn(input, "expect_return") || hasOwn(input, "expectReturn") || hasOwn(input, "expected_return") || hasOwn(input, "expectedReturn");
+  const storeReturnTo = stringFromOwn(
+    input,
+    "store_return_to",
+    "storeReturnTo",
+    "save_return_to",
+    "saveReturnTo",
+    "assign_return_to",
+    "assignReturnTo",
+    "return_state_path",
+    "returnStatePath"
+  );
+  const captureReturn = input.capture_return === false || input.captureReturn === false || input.include_return === false || input.includeReturn === false || input.omit_return === true || input.omitReturn === true ? false : void 0;
   const untilPath = stringFromOwn(input, "until_path", "untilPath", "until_state_path", "untilStatePath", "until_window_path", "untilWindowPath", "until");
   const hasUntilExpectedValue = hasOwn(input, "until_expected_value") || hasOwn(input, "untilExpectedValue") || hasOwn(input, "until_expected") || hasOwn(input, "untilExpected") || hasOwn(input, "until_value") || hasOwn(input, "untilValue") || hasOwn(input, "expected_value") || hasOwn(input, "expectedValue") || hasOwn(input, "expected");
   if (type === "window_call_until") {
@@ -7713,6 +7725,8 @@ function normalizeSetupAction(input, index) {
     path: path7,
     args,
     expect_return: hasExpectedReturn ? toJsonValue(valueFromOwn(input, "expect_return", "expectReturn", "expected_return", "expectedReturn")) : void 0,
+    store_return_to: storeReturnTo,
+    capture_return: captureReturn,
     until_path: untilPath,
     until_expected_value: hasUntilExpectedValue ? toJsonValue(valueFromOwn(input, "until_expected_value", "untilExpectedValue", "until_expected", "untilExpected", "until_value", "untilValue", "expected_value", "expectedValue", "expected")) : void 0,
     max_calls: maxCalls,
@@ -10574,6 +10588,21 @@ function profileSetupScreenshotLabels(results) {
     .map((result) => result.screenshot_label)
     .filter(Boolean);
 }
+function profileSetupWindowCallUntilReceipts(results) {
+  return (results || [])
+    .filter((result) => result && profileSetupResultAction(result) === "window_call_until")
+    .map((result) => ({
+      ordinal: result.ordinal ?? null,
+      ok: result.ok !== false,
+      path: result.path ?? null,
+      until_path: result.until_path ?? null,
+      until_value: result.until_value ?? null,
+      until_expected_value: result.until_expected_value ?? null,
+      call_count: result.call_count ?? null,
+      max_calls: result.max_calls ?? null,
+      reason: result.reason || result.error || null,
+    }));
+}
 function sampleProfileSetupSummaryItems(items, limit) {
   if ((items || []).length <= limit) return items || [];
   const firstCount = Math.floor(limit / 2);
@@ -10603,6 +10632,11 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
       const clickCountValues = successfulClicks
         .map((result) => typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : undefined)
         .filter((value) => value !== undefined);
+      const windowCallUntilReceipts = profileSetupWindowCallUntilReceipts(results);
+      const windowCallUntilCallCounts = windowCallUntilReceipts
+        .map((result) => typeof result.call_count === "number" && Number.isFinite(result.call_count) ? result.call_count : undefined)
+        .filter((value) => value !== undefined);
+      const sampledWindowCallUntilReceipts = sampleProfileSetupSummaryItems(windowCallUntilReceipts, 8);
       const clickedItems = results
         .filter((result) => result && profileSetupResultAction(result) === "click" && result.ok !== false)
         .map((result) => {
@@ -10645,6 +10679,10 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         clicked_truncated: clickedItems.length > clicked.length,
         click_count_action_total: clickCountValues.length,
         click_count_value_total: clickCountValues.reduce((sum, value) => sum + value, 0),
+        window_call_until_total: windowCallUntilReceipts.length,
+        window_call_until_call_total: windowCallUntilCallCounts.reduce((sum, value) => sum + value, 0),
+        window_call_until_truncated: windowCallUntilReceipts.length > sampledWindowCallUntilReceipts.length,
+        window_call_until: sampledWindowCallUntilReceipts,
         clicked,
         text_samples: textSamples,
         failed: failed.map((result) => ({
@@ -11577,8 +11615,8 @@ async function setupReadWindowValue(context, path) {
     return { ok: true, value: toJsonValue(current) };
   }, { path });
 }
-async function setupCallWindowFunction(context, path, args) {
-  return await context.evaluate(async ({ path, args }) => {
+async function setupCallWindowFunction(context, path, args, storeReturnTo, captureReturn) {
+  return await context.evaluate(async ({ path, args, storeReturnTo, captureReturn }) => {
     const toJsonValue = (value) => {
       if (value === null || value === undefined) return null;
       if (typeof value === "string" || typeof value === "boolean") return value;
@@ -11589,6 +11627,19 @@ async function setupCallWindowFunction(context, path, args) {
       }
       return String(value);
     };
+    const storeWindowReturn = (storePath, value) => {
+      const pathParts = String(storePath || "").split(".").map((part) => part.trim()).filter(Boolean);
+      if (pathParts[0] === "window") pathParts.shift();
+      if (!pathParts.length) return { ok: false, reason: "missing_store_path" };
+      let target = window;
+      for (let index = 0; index < pathParts.length - 1; index += 1) {
+        const part = pathParts[index];
+        if (target[part] === null || typeof target[part] !== "object") target[part] = {};
+        target = target[part];
+      }
+      target[pathParts[pathParts.length - 1]] = value;
+      return { ok: true, path: pathParts.join(".") };
+    };
     const pathParts = String(path || "").split(".").map((part) => part.trim()).filter(Boolean);
     let parent = window;
     let current = window;
@@ -11599,11 +11650,18 @@ async function setupCallWindowFunction(context, path, args) {
     if (typeof current !== "function") return { ok: false, reason: "missing_function" };
     try {
       const returned = await current.apply(parent, Array.isArray(args) ? args : []);
-      return { ok: true, returned: toJsonValue(returned) };
+      const jsonReturned = toJsonValue(returned);
+      const returnedForResult = captureReturn === false ? undefined : jsonReturned;
+      if (storeReturnTo) {
+        const stored = storeWindowReturn(storeReturnTo, jsonReturned);
+        if (!stored.ok) return { ok: false, reason: "return_store_failed", store_reason: stored.reason, returned: returnedForResult };
+        return { ok: true, returned: returnedForResult, return_stored_to: stored.path };
+      }
+      return { ok: true, returned: returnedForResult };
     } catch (error) {
       return { ok: false, reason: "function_threw", error: String(error && error.message ? error.message : error).slice(0, 1000) };
     }
-  }, { path, args });
+  }, { path, args, storeReturnTo, captureReturn });
 }
 function setupFrameSelector(action) {
   return String(action?.frame_selector || action?.frameSelector || action?.iframe_selector || action?.iframeSelector || "").trim();
@@ -12119,10 +12177,10 @@ async function executeSetupAction(action, ordinal, viewport) {
     if (type === "window_call") {
       const path = String(action.path || action.function_path || action.functionPath || "");
       const args = Array.isArray(action.args) ? action.args : [];
+      const storeReturnTo = String(action.store_return_to || action.storeReturnTo || action.save_return_to || action.saveReturnTo || action.assign_return_to || action.assignReturnTo || action.return_state_path || action.returnStatePath || "").trim();
       if (!path) return { ...base, path, reason: "missing_path" };
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
-      const result = await setupCallWindowFunction(scope.context, path, args);
       const hasExpectation = setupHasOwn(action, "expect_return")
         || setupHasOwn(action, "expectReturn")
         || setupHasOwn(action, "expected_return")
@@ -12131,9 +12189,13 @@ async function executeSetupAction(action, ordinal, viewport) {
         ? action.expect_return
         : setupHasOwn(action, "expectReturn")
           ? action.expectReturn
-          : setupHasOwn(action, "expected_return")
-            ? action.expected_return
-            : action.expectedReturn;
+        : setupHasOwn(action, "expected_return")
+          ? action.expected_return
+          : action.expectedReturn;
+      const captureReturn = action.capture_return === false || action.captureReturn === false || action.include_return === false || action.includeReturn === false || action.omit_return === true || action.omitReturn === true
+        ? hasExpectation
+        : true;
+      const result = await setupCallWindowFunction(scope.context, path, args, storeReturnTo, captureReturn);
       const expectationMet = !hasExpectation || setupValuesEqual(result.returned, expected);
       return {
         ...base,
@@ -12141,9 +12203,12 @@ async function executeSetupAction(action, ordinal, viewport) {
         ok: Boolean(result.ok && expectationMet),
         path,
         arg_count: args.length,
-        returned: setupJsonValue(result.returned),
+        returned: captureReturn ? setupJsonValue(result.returned) : undefined,
+        return_captured: captureReturn,
         expected_return: hasExpectation ? setupJsonValue(expected) : undefined,
+        return_stored_to: result.return_stored_to || storeReturnTo || undefined,
         reason: result.ok ? (expectationMet ? undefined : "unexpected_return_value") : result.reason,
+        store_reason: result.store_reason || undefined,
         error: result.error || undefined,
       };
     }
@@ -12151,6 +12216,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       const path = String(action.path || action.function_path || action.functionPath || "");
       const untilPath = String(action.until_path || action.untilPath || action.until_state_path || action.untilStatePath || action.until_window_path || action.untilWindowPath || action.until || "");
       const args = Array.isArray(action.args) ? action.args : [];
+      const storeReturnTo = String(action.store_return_to || action.storeReturnTo || action.save_return_to || action.saveReturnTo || action.assign_return_to || action.assignReturnTo || action.return_state_path || action.returnStatePath || "").trim();
       if (!path) return { ...base, path, reason: "missing_path" };
       if (!untilPath) return { ...base, path, reason: "missing_until_path" };
       const hasUntilExpected = setupHasOwn(action, "until_expected_value")
@@ -12193,6 +12259,9 @@ async function executeSetupAction(action, ordinal, viewport) {
           : setupHasOwn(action, "expected_return")
             ? action.expected_return
             : action.expectedReturn;
+      const captureReturn = action.capture_return === false || action.captureReturn === false || action.include_return === false || action.includeReturn === false || action.omit_return === true || action.omitReturn === true
+        ? hasReturnExpectation
+        : true;
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
       const startedAt = Date.now();
@@ -12216,7 +12285,7 @@ async function executeSetupAction(action, ordinal, viewport) {
         };
       }
       while (callCount < maxCalls && Date.now() - startedAt <= timeout) {
-        lastCallResult = await setupCallWindowFunction(scope.context, path, args);
+        lastCallResult = await setupCallWindowFunction(scope.context, path, args, storeReturnTo, captureReturn);
         callCount += 1;
         if (!lastCallResult.ok) break;
         if (hasReturnExpectation && !setupValuesEqual(lastCallResult.returned, expectedReturn)) break;
@@ -12228,8 +12297,10 @@ async function executeSetupAction(action, ordinal, viewport) {
             ok: true,
             path,
             arg_count: args.length,
-            returned: setupJsonValue(lastCallResult.returned),
+            returned: captureReturn ? setupJsonValue(lastCallResult.returned) : undefined,
+            return_captured: captureReturn,
             expected_return: hasReturnExpectation ? setupJsonValue(expectedReturn) : undefined,
+            return_stored_to: lastCallResult.return_stored_to || storeReturnTo || undefined,
             until_path: untilPath,
             until_value: setupJsonValue(lastPredicateResult.value),
             until_expected_value: setupJsonValue(untilExpected),
@@ -12247,8 +12318,10 @@ async function executeSetupAction(action, ordinal, viewport) {
         ...setupScopeEvidence(scope),
         path,
         arg_count: args.length,
-        returned: setupJsonValue(lastCallResult?.returned),
+        returned: captureReturn ? setupJsonValue(lastCallResult?.returned) : undefined,
+        return_captured: captureReturn,
         expected_return: hasReturnExpectation ? setupJsonValue(expectedReturn) : undefined,
+        return_stored_to: lastCallResult?.return_stored_to || storeReturnTo || undefined,
         until_path: untilPath,
         until_value: setupJsonValue(lastPredicateResult?.value),
         until_expected_value: setupJsonValue(untilExpected),
@@ -12264,6 +12337,7 @@ async function executeSetupAction(action, ordinal, viewport) {
               ? "timeout"
               : "until_condition_not_met",
         error: lastCallResult?.error || undefined,
+        store_reason: lastCallResult?.store_reason || undefined,
         missing_part: lastPredicateResult?.missing_part || undefined,
       };
     }

package/dist/cli.js

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

package/dist/index.cjs

@@ -9465,6 +9465,18 @@ function normalizeSetupAction(input, index) {
     }
   }
   const hasExpectedReturn = hasOwn(input, "expect_return") || hasOwn(input, "expectReturn") || hasOwn(input, "expected_return") || hasOwn(input, "expectedReturn");
+  const storeReturnTo = stringFromOwn(
+    input,
+    "store_return_to",
+    "storeReturnTo",
+    "save_return_to",
+    "saveReturnTo",
+    "assign_return_to",
+    "assignReturnTo",
+    "return_state_path",
+    "returnStatePath"
+  );
+  const captureReturn = input.capture_return === false || input.captureReturn === false || input.include_return === false || input.includeReturn === false || input.omit_return === true || input.omitReturn === true ? false : void 0;
   const untilPath = stringFromOwn(input, "until_path", "untilPath", "until_state_path", "untilStatePath", "until_window_path", "untilWindowPath", "until");
   const hasUntilExpectedValue = hasOwn(input, "until_expected_value") || hasOwn(input, "untilExpectedValue") || hasOwn(input, "until_expected") || hasOwn(input, "untilExpected") || hasOwn(input, "until_value") || hasOwn(input, "untilValue") || hasOwn(input, "expected_value") || hasOwn(input, "expectedValue") || hasOwn(input, "expected");
   if (type === "window_call_until") {
@@ -9509,6 +9521,8 @@ function normalizeSetupAction(input, index) {
     path: path6,
     args,
     expect_return: hasExpectedReturn ? toJsonValue(valueFromOwn(input, "expect_return", "expectReturn", "expected_return", "expectedReturn")) : void 0,
+    store_return_to: storeReturnTo,
+    capture_return: captureReturn,
     until_path: untilPath,
     until_expected_value: hasUntilExpectedValue ? toJsonValue(valueFromOwn(input, "until_expected_value", "untilExpectedValue", "until_expected", "untilExpected", "until_value", "untilValue", "expected_value", "expectedValue", "expected")) : void 0,
     max_calls: maxCalls,
@@ -12386,6 +12400,21 @@ function profileSetupScreenshotLabels(results) {
     .map((result) => result.screenshot_label)
     .filter(Boolean);
 }
+function profileSetupWindowCallUntilReceipts(results) {
+  return (results || [])
+    .filter((result) => result && profileSetupResultAction(result) === "window_call_until")
+    .map((result) => ({
+      ordinal: result.ordinal ?? null,
+      ok: result.ok !== false,
+      path: result.path ?? null,
+      until_path: result.until_path ?? null,
+      until_value: result.until_value ?? null,
+      until_expected_value: result.until_expected_value ?? null,
+      call_count: result.call_count ?? null,
+      max_calls: result.max_calls ?? null,
+      reason: result.reason || result.error || null,
+    }));
+}
 function sampleProfileSetupSummaryItems(items, limit) {
   if ((items || []).length <= limit) return items || [];
   const firstCount = Math.floor(limit / 2);
@@ -12415,6 +12444,11 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
       const clickCountValues = successfulClicks
         .map((result) => typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : undefined)
         .filter((value) => value !== undefined);
+      const windowCallUntilReceipts = profileSetupWindowCallUntilReceipts(results);
+      const windowCallUntilCallCounts = windowCallUntilReceipts
+        .map((result) => typeof result.call_count === "number" && Number.isFinite(result.call_count) ? result.call_count : undefined)
+        .filter((value) => value !== undefined);
+      const sampledWindowCallUntilReceipts = sampleProfileSetupSummaryItems(windowCallUntilReceipts, 8);
       const clickedItems = results
         .filter((result) => result && profileSetupResultAction(result) === "click" && result.ok !== false)
         .map((result) => {
@@ -12457,6 +12491,10 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         clicked_truncated: clickedItems.length > clicked.length,
         click_count_action_total: clickCountValues.length,
         click_count_value_total: clickCountValues.reduce((sum, value) => sum + value, 0),
+        window_call_until_total: windowCallUntilReceipts.length,
+        window_call_until_call_total: windowCallUntilCallCounts.reduce((sum, value) => sum + value, 0),
+        window_call_until_truncated: windowCallUntilReceipts.length > sampledWindowCallUntilReceipts.length,
+        window_call_until: sampledWindowCallUntilReceipts,
         clicked,
         text_samples: textSamples,
         failed: failed.map((result) => ({
@@ -13389,8 +13427,8 @@ async function setupReadWindowValue(context, path) {
     return { ok: true, value: toJsonValue(current) };
   }, { path });
 }
-async function setupCallWindowFunction(context, path, args) {
-  return await context.evaluate(async ({ path, args }) => {
+async function setupCallWindowFunction(context, path, args, storeReturnTo, captureReturn) {
+  return await context.evaluate(async ({ path, args, storeReturnTo, captureReturn }) => {
     const toJsonValue = (value) => {
       if (value === null || value === undefined) return null;
       if (typeof value === "string" || typeof value === "boolean") return value;
@@ -13401,6 +13439,19 @@ async function setupCallWindowFunction(context, path, args) {
       }
       return String(value);
     };
+    const storeWindowReturn = (storePath, value) => {
+      const pathParts = String(storePath || "").split(".").map((part) => part.trim()).filter(Boolean);
+      if (pathParts[0] === "window") pathParts.shift();
+      if (!pathParts.length) return { ok: false, reason: "missing_store_path" };
+      let target = window;
+      for (let index = 0; index < pathParts.length - 1; index += 1) {
+        const part = pathParts[index];
+        if (target[part] === null || typeof target[part] !== "object") target[part] = {};
+        target = target[part];
+      }
+      target[pathParts[pathParts.length - 1]] = value;
+      return { ok: true, path: pathParts.join(".") };
+    };
     const pathParts = String(path || "").split(".").map((part) => part.trim()).filter(Boolean);
     let parent = window;
     let current = window;
@@ -13411,11 +13462,18 @@ async function setupCallWindowFunction(context, path, args) {
     if (typeof current !== "function") return { ok: false, reason: "missing_function" };
     try {
       const returned = await current.apply(parent, Array.isArray(args) ? args : []);
-      return { ok: true, returned: toJsonValue(returned) };
+      const jsonReturned = toJsonValue(returned);
+      const returnedForResult = captureReturn === false ? undefined : jsonReturned;
+      if (storeReturnTo) {
+        const stored = storeWindowReturn(storeReturnTo, jsonReturned);
+        if (!stored.ok) return { ok: false, reason: "return_store_failed", store_reason: stored.reason, returned: returnedForResult };
+        return { ok: true, returned: returnedForResult, return_stored_to: stored.path };
+      }
+      return { ok: true, returned: returnedForResult };
     } catch (error) {
       return { ok: false, reason: "function_threw", error: String(error && error.message ? error.message : error).slice(0, 1000) };
     }
-  }, { path, args });
+  }, { path, args, storeReturnTo, captureReturn });
 }
 function setupFrameSelector(action) {
   return String(action?.frame_selector || action?.frameSelector || action?.iframe_selector || action?.iframeSelector || "").trim();
@@ -13931,10 +13989,10 @@ async function executeSetupAction(action, ordinal, viewport) {
     if (type === "window_call") {
       const path = String(action.path || action.function_path || action.functionPath || "");
       const args = Array.isArray(action.args) ? action.args : [];
+      const storeReturnTo = String(action.store_return_to || action.storeReturnTo || action.save_return_to || action.saveReturnTo || action.assign_return_to || action.assignReturnTo || action.return_state_path || action.returnStatePath || "").trim();
       if (!path) return { ...base, path, reason: "missing_path" };
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
-      const result = await setupCallWindowFunction(scope.context, path, args);
       const hasExpectation = setupHasOwn(action, "expect_return")
         || setupHasOwn(action, "expectReturn")
         || setupHasOwn(action, "expected_return")
@@ -13943,9 +14001,13 @@ async function executeSetupAction(action, ordinal, viewport) {
         ? action.expect_return
         : setupHasOwn(action, "expectReturn")
           ? action.expectReturn
-          : setupHasOwn(action, "expected_return")
-            ? action.expected_return
-            : action.expectedReturn;
+        : setupHasOwn(action, "expected_return")
+          ? action.expected_return
+          : action.expectedReturn;
+      const captureReturn = action.capture_return === false || action.captureReturn === false || action.include_return === false || action.includeReturn === false || action.omit_return === true || action.omitReturn === true
+        ? hasExpectation
+        : true;
+      const result = await setupCallWindowFunction(scope.context, path, args, storeReturnTo, captureReturn);
       const expectationMet = !hasExpectation || setupValuesEqual(result.returned, expected);
       return {
         ...base,
@@ -13953,9 +14015,12 @@ async function executeSetupAction(action, ordinal, viewport) {
         ok: Boolean(result.ok && expectationMet),
         path,
         arg_count: args.length,
-        returned: setupJsonValue(result.returned),
+        returned: captureReturn ? setupJsonValue(result.returned) : undefined,
+        return_captured: captureReturn,
         expected_return: hasExpectation ? setupJsonValue(expected) : undefined,
+        return_stored_to: result.return_stored_to || storeReturnTo || undefined,
         reason: result.ok ? (expectationMet ? undefined : "unexpected_return_value") : result.reason,
+        store_reason: result.store_reason || undefined,
         error: result.error || undefined,
       };
     }
@@ -13963,6 +14028,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       const path = String(action.path || action.function_path || action.functionPath || "");
       const untilPath = String(action.until_path || action.untilPath || action.until_state_path || action.untilStatePath || action.until_window_path || action.untilWindowPath || action.until || "");
       const args = Array.isArray(action.args) ? action.args : [];
+      const storeReturnTo = String(action.store_return_to || action.storeReturnTo || action.save_return_to || action.saveReturnTo || action.assign_return_to || action.assignReturnTo || action.return_state_path || action.returnStatePath || "").trim();
       if (!path) return { ...base, path, reason: "missing_path" };
       if (!untilPath) return { ...base, path, reason: "missing_until_path" };
       const hasUntilExpected = setupHasOwn(action, "until_expected_value")
@@ -14005,6 +14071,9 @@ async function executeSetupAction(action, ordinal, viewport) {
           : setupHasOwn(action, "expected_return")
             ? action.expected_return
             : action.expectedReturn;
+      const captureReturn = action.capture_return === false || action.captureReturn === false || action.include_return === false || action.includeReturn === false || action.omit_return === true || action.omitReturn === true
+        ? hasReturnExpectation
+        : true;
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
       const startedAt = Date.now();
@@ -14028,7 +14097,7 @@ async function executeSetupAction(action, ordinal, viewport) {
         };
       }
       while (callCount < maxCalls && Date.now() - startedAt <= timeout) {
-        lastCallResult = await setupCallWindowFunction(scope.context, path, args);
+        lastCallResult = await setupCallWindowFunction(scope.context, path, args, storeReturnTo, captureReturn);
         callCount += 1;
         if (!lastCallResult.ok) break;
         if (hasReturnExpectation && !setupValuesEqual(lastCallResult.returned, expectedReturn)) break;
@@ -14040,8 +14109,10 @@ async function executeSetupAction(action, ordinal, viewport) {
             ok: true,
             path,
             arg_count: args.length,
-            returned: setupJsonValue(lastCallResult.returned),
+            returned: captureReturn ? setupJsonValue(lastCallResult.returned) : undefined,
+            return_captured: captureReturn,
             expected_return: hasReturnExpectation ? setupJsonValue(expectedReturn) : undefined,
+            return_stored_to: lastCallResult.return_stored_to || storeReturnTo || undefined,
             until_path: untilPath,
             until_value: setupJsonValue(lastPredicateResult.value),
             until_expected_value: setupJsonValue(untilExpected),
@@ -14059,8 +14130,10 @@ async function executeSetupAction(action, ordinal, viewport) {
         ...setupScopeEvidence(scope),
         path,
         arg_count: args.length,
-        returned: setupJsonValue(lastCallResult?.returned),
+        returned: captureReturn ? setupJsonValue(lastCallResult?.returned) : undefined,
+        return_captured: captureReturn,
         expected_return: hasReturnExpectation ? setupJsonValue(expectedReturn) : undefined,
+        return_stored_to: lastCallResult?.return_stored_to || storeReturnTo || undefined,
         until_path: untilPath,
         until_value: setupJsonValue(lastPredicateResult?.value),
         until_expected_value: setupJsonValue(untilExpected),
@@ -14076,6 +14149,7 @@ async function executeSetupAction(action, ordinal, viewport) {
               ? "timeout"
               : "until_condition_not_met",
         error: lastCallResult?.error || undefined,
+        store_reason: lastCallResult?.store_reason || undefined,
         missing_part: lastPredicateResult?.missing_part || undefined,
       };
     }

package/dist/index.js

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

package/dist/profile.cjs

@@ -779,6 +779,18 @@ function normalizeSetupAction(input, index) {
     }
   }
   const hasExpectedReturn = hasOwn(input, "expect_return") || hasOwn(input, "expectReturn") || hasOwn(input, "expected_return") || hasOwn(input, "expectedReturn");
+  const storeReturnTo = stringFromOwn(
+    input,
+    "store_return_to",
+    "storeReturnTo",
+    "save_return_to",
+    "saveReturnTo",
+    "assign_return_to",
+    "assignReturnTo",
+    "return_state_path",
+    "returnStatePath"
+  );
+  const captureReturn = input.capture_return === false || input.captureReturn === false || input.include_return === false || input.includeReturn === false || input.omit_return === true || input.omitReturn === true ? false : void 0;
   const untilPath = stringFromOwn(input, "until_path", "untilPath", "until_state_path", "untilStatePath", "until_window_path", "untilWindowPath", "until");
   const hasUntilExpectedValue = hasOwn(input, "until_expected_value") || hasOwn(input, "untilExpectedValue") || hasOwn(input, "until_expected") || hasOwn(input, "untilExpected") || hasOwn(input, "until_value") || hasOwn(input, "untilValue") || hasOwn(input, "expected_value") || hasOwn(input, "expectedValue") || hasOwn(input, "expected");
   if (type === "window_call_until") {
@@ -823,6 +835,8 @@ function normalizeSetupAction(input, index) {
     path,
     args,
     expect_return: hasExpectedReturn ? toJsonValue(valueFromOwn(input, "expect_return", "expectReturn", "expected_return", "expectedReturn")) : void 0,
+    store_return_to: storeReturnTo,
+    capture_return: captureReturn,
     until_path: untilPath,
     until_expected_value: hasUntilExpectedValue ? toJsonValue(valueFromOwn(input, "until_expected_value", "untilExpectedValue", "until_expected", "untilExpected", "until_value", "untilValue", "expected_value", "expectedValue", "expected")) : void 0,
     max_calls: maxCalls,
@@ -3700,6 +3714,21 @@ function profileSetupScreenshotLabels(results) {
     .map((result) => result.screenshot_label)
     .filter(Boolean);
 }
+function profileSetupWindowCallUntilReceipts(results) {
+  return (results || [])
+    .filter((result) => result && profileSetupResultAction(result) === "window_call_until")
+    .map((result) => ({
+      ordinal: result.ordinal ?? null,
+      ok: result.ok !== false,
+      path: result.path ?? null,
+      until_path: result.until_path ?? null,
+      until_value: result.until_value ?? null,
+      until_expected_value: result.until_expected_value ?? null,
+      call_count: result.call_count ?? null,
+      max_calls: result.max_calls ?? null,
+      reason: result.reason || result.error || null,
+    }));
+}
 function sampleProfileSetupSummaryItems(items, limit) {
   if ((items || []).length <= limit) return items || [];
   const firstCount = Math.floor(limit / 2);
@@ -3729,6 +3758,11 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
       const clickCountValues = successfulClicks
         .map((result) => typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : undefined)
         .filter((value) => value !== undefined);
+      const windowCallUntilReceipts = profileSetupWindowCallUntilReceipts(results);
+      const windowCallUntilCallCounts = windowCallUntilReceipts
+        .map((result) => typeof result.call_count === "number" && Number.isFinite(result.call_count) ? result.call_count : undefined)
+        .filter((value) => value !== undefined);
+      const sampledWindowCallUntilReceipts = sampleProfileSetupSummaryItems(windowCallUntilReceipts, 8);
       const clickedItems = results
         .filter((result) => result && profileSetupResultAction(result) === "click" && result.ok !== false)
         .map((result) => {
@@ -3771,6 +3805,10 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         clicked_truncated: clickedItems.length > clicked.length,
         click_count_action_total: clickCountValues.length,
         click_count_value_total: clickCountValues.reduce((sum, value) => sum + value, 0),
+        window_call_until_total: windowCallUntilReceipts.length,
+        window_call_until_call_total: windowCallUntilCallCounts.reduce((sum, value) => sum + value, 0),
+        window_call_until_truncated: windowCallUntilReceipts.length > sampledWindowCallUntilReceipts.length,
+        window_call_until: sampledWindowCallUntilReceipts,
         clicked,
         text_samples: textSamples,
         failed: failed.map((result) => ({
@@ -4703,8 +4741,8 @@ async function setupReadWindowValue(context, path) {
     return { ok: true, value: toJsonValue(current) };
   }, { path });
 }
-async function setupCallWindowFunction(context, path, args) {
-  return await context.evaluate(async ({ path, args }) => {
+async function setupCallWindowFunction(context, path, args, storeReturnTo, captureReturn) {
+  return await context.evaluate(async ({ path, args, storeReturnTo, captureReturn }) => {
     const toJsonValue = (value) => {
       if (value === null || value === undefined) return null;
       if (typeof value === "string" || typeof value === "boolean") return value;
@@ -4715,6 +4753,19 @@ async function setupCallWindowFunction(context, path, args) {
       }
       return String(value);
     };
+    const storeWindowReturn = (storePath, value) => {
+      const pathParts = String(storePath || "").split(".").map((part) => part.trim()).filter(Boolean);
+      if (pathParts[0] === "window") pathParts.shift();
+      if (!pathParts.length) return { ok: false, reason: "missing_store_path" };
+      let target = window;
+      for (let index = 0; index < pathParts.length - 1; index += 1) {
+        const part = pathParts[index];
+        if (target[part] === null || typeof target[part] !== "object") target[part] = {};
+        target = target[part];
+      }
+      target[pathParts[pathParts.length - 1]] = value;
+      return { ok: true, path: pathParts.join(".") };
+    };
     const pathParts = String(path || "").split(".").map((part) => part.trim()).filter(Boolean);
     let parent = window;
     let current = window;
@@ -4725,11 +4776,18 @@ async function setupCallWindowFunction(context, path, args) {
     if (typeof current !== "function") return { ok: false, reason: "missing_function" };
     try {
       const returned = await current.apply(parent, Array.isArray(args) ? args : []);
-      return { ok: true, returned: toJsonValue(returned) };
+      const jsonReturned = toJsonValue(returned);
+      const returnedForResult = captureReturn === false ? undefined : jsonReturned;
+      if (storeReturnTo) {
+        const stored = storeWindowReturn(storeReturnTo, jsonReturned);
+        if (!stored.ok) return { ok: false, reason: "return_store_failed", store_reason: stored.reason, returned: returnedForResult };
+        return { ok: true, returned: returnedForResult, return_stored_to: stored.path };
+      }
+      return { ok: true, returned: returnedForResult };
     } catch (error) {
       return { ok: false, reason: "function_threw", error: String(error && error.message ? error.message : error).slice(0, 1000) };
     }
-  }, { path, args });
+  }, { path, args, storeReturnTo, captureReturn });
 }
 function setupFrameSelector(action) {
   return String(action?.frame_selector || action?.frameSelector || action?.iframe_selector || action?.iframeSelector || "").trim();
@@ -5245,10 +5303,10 @@ async function executeSetupAction(action, ordinal, viewport) {
     if (type === "window_call") {
       const path = String(action.path || action.function_path || action.functionPath || "");
       const args = Array.isArray(action.args) ? action.args : [];
+      const storeReturnTo = String(action.store_return_to || action.storeReturnTo || action.save_return_to || action.saveReturnTo || action.assign_return_to || action.assignReturnTo || action.return_state_path || action.returnStatePath || "").trim();
       if (!path) return { ...base, path, reason: "missing_path" };
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
-      const result = await setupCallWindowFunction(scope.context, path, args);
       const hasExpectation = setupHasOwn(action, "expect_return")
         || setupHasOwn(action, "expectReturn")
         || setupHasOwn(action, "expected_return")
@@ -5257,9 +5315,13 @@ async function executeSetupAction(action, ordinal, viewport) {
         ? action.expect_return
         : setupHasOwn(action, "expectReturn")
           ? action.expectReturn
-          : setupHasOwn(action, "expected_return")
-            ? action.expected_return
-            : action.expectedReturn;
+        : setupHasOwn(action, "expected_return")
+          ? action.expected_return
+          : action.expectedReturn;
+      const captureReturn = action.capture_return === false || action.captureReturn === false || action.include_return === false || action.includeReturn === false || action.omit_return === true || action.omitReturn === true
+        ? hasExpectation
+        : true;
+      const result = await setupCallWindowFunction(scope.context, path, args, storeReturnTo, captureReturn);
       const expectationMet = !hasExpectation || setupValuesEqual(result.returned, expected);
       return {
         ...base,
@@ -5267,9 +5329,12 @@ async function executeSetupAction(action, ordinal, viewport) {
         ok: Boolean(result.ok && expectationMet),
         path,
         arg_count: args.length,
-        returned: setupJsonValue(result.returned),
+        returned: captureReturn ? setupJsonValue(result.returned) : undefined,
+        return_captured: captureReturn,
         expected_return: hasExpectation ? setupJsonValue(expected) : undefined,
+        return_stored_to: result.return_stored_to || storeReturnTo || undefined,
         reason: result.ok ? (expectationMet ? undefined : "unexpected_return_value") : result.reason,
+        store_reason: result.store_reason || undefined,
         error: result.error || undefined,
       };
     }
@@ -5277,6 +5342,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       const path = String(action.path || action.function_path || action.functionPath || "");
       const untilPath = String(action.until_path || action.untilPath || action.until_state_path || action.untilStatePath || action.until_window_path || action.untilWindowPath || action.until || "");
       const args = Array.isArray(action.args) ? action.args : [];
+      const storeReturnTo = String(action.store_return_to || action.storeReturnTo || action.save_return_to || action.saveReturnTo || action.assign_return_to || action.assignReturnTo || action.return_state_path || action.returnStatePath || "").trim();
       if (!path) return { ...base, path, reason: "missing_path" };
       if (!untilPath) return { ...base, path, reason: "missing_until_path" };
       const hasUntilExpected = setupHasOwn(action, "until_expected_value")
@@ -5319,6 +5385,9 @@ async function executeSetupAction(action, ordinal, viewport) {
           : setupHasOwn(action, "expected_return")
             ? action.expected_return
             : action.expectedReturn;
+      const captureReturn = action.capture_return === false || action.captureReturn === false || action.include_return === false || action.includeReturn === false || action.omit_return === true || action.omitReturn === true
+        ? hasReturnExpectation
+        : true;
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
       const startedAt = Date.now();
@@ -5342,7 +5411,7 @@ async function executeSetupAction(action, ordinal, viewport) {
         };
       }
       while (callCount < maxCalls && Date.now() - startedAt <= timeout) {
-        lastCallResult = await setupCallWindowFunction(scope.context, path, args);
+        lastCallResult = await setupCallWindowFunction(scope.context, path, args, storeReturnTo, captureReturn);
         callCount += 1;
         if (!lastCallResult.ok) break;
         if (hasReturnExpectation && !setupValuesEqual(lastCallResult.returned, expectedReturn)) break;
@@ -5354,8 +5423,10 @@ async function executeSetupAction(action, ordinal, viewport) {
             ok: true,
             path,
             arg_count: args.length,
-            returned: setupJsonValue(lastCallResult.returned),
+            returned: captureReturn ? setupJsonValue(lastCallResult.returned) : undefined,
+            return_captured: captureReturn,
             expected_return: hasReturnExpectation ? setupJsonValue(expectedReturn) : undefined,
+            return_stored_to: lastCallResult.return_stored_to || storeReturnTo || undefined,
             until_path: untilPath,
             until_value: setupJsonValue(lastPredicateResult.value),
             until_expected_value: setupJsonValue(untilExpected),
@@ -5373,8 +5444,10 @@ async function executeSetupAction(action, ordinal, viewport) {
         ...setupScopeEvidence(scope),
         path,
         arg_count: args.length,
-        returned: setupJsonValue(lastCallResult?.returned),
+        returned: captureReturn ? setupJsonValue(lastCallResult?.returned) : undefined,
+        return_captured: captureReturn,
         expected_return: hasReturnExpectation ? setupJsonValue(expectedReturn) : undefined,
+        return_stored_to: lastCallResult?.return_stored_to || storeReturnTo || undefined,
         until_path: untilPath,
         until_value: setupJsonValue(lastPredicateResult?.value),
         until_expected_value: setupJsonValue(untilExpected),
@@ -5390,6 +5463,7 @@ async function executeSetupAction(action, ordinal, viewport) {
               ? "timeout"
               : "until_condition_not_met",
         error: lastCallResult?.error || undefined,
+        store_reason: lastCallResult?.store_reason || undefined,
         missing_part: lastPredicateResult?.missing_part || undefined,
       };
     }

package/dist/profile.d.cts

@@ -129,6 +129,8 @@ interface RiddleProofProfileSetupAction {
     path?: string;
     args?: JsonValue[];
     expect_return?: JsonValue;
+    store_return_to?: string;
+    capture_return?: boolean;
     until_path?: string;
     until_expected_value?: JsonValue;
     max_calls?: number;

package/dist/profile.d.ts

@@ -129,6 +129,8 @@ interface RiddleProofProfileSetupAction {
     path?: string;
     args?: JsonValue[];
     expect_return?: JsonValue;
+    store_return_to?: string;
+    capture_return?: boolean;
     until_path?: string;
     until_expected_value?: JsonValue;
     max_calls?: number;

package/dist/profile.js

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