@riddledc/riddle-proof 0.7.135 → 0.7.136

package/dist/{chunk-4IAUK6C6.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,
@@ -4680,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;
@@ -4692,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;
@@ -4702,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();
@@ -5222,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")
@@ -5234,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,
@@ -5244,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,
       };
     }
@@ -5254,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")
@@ -5296,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();
@@ -5319,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;
@@ -5331,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),
@@ -5350,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),
@@ -5367,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,
@@ -11601,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;
@@ -11613,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;
@@ -11623,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();
@@ -12143,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")
@@ -12155,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,
@@ -12165,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,
       };
     }
@@ -12175,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")
@@ -12217,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();
@@ -12240,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;
@@ -12252,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),
@@ -12271,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),
@@ -12288,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-4IAUK6C6.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,
@@ -13413,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;
@@ -13425,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;
@@ -13435,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();
@@ -13955,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")
@@ -13967,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,
@@ -13977,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,
       };
     }
@@ -13987,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")
@@ -14029,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();
@@ -14052,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;
@@ -14064,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),
@@ -14083,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),
@@ -14100,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-4IAUK6C6.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,
@@ -4727,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;
@@ -4739,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;
@@ -4749,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();
@@ -5269,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")
@@ -5281,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,
@@ -5291,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,
       };
     }
@@ -5301,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")
@@ -5343,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();
@@ -5366,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;
@@ -5378,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),
@@ -5397,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),
@@ -5414,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-4IAUK6C6.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.135",
+  "version": "0.7.136",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",