@riddledc/riddle-proof 0.7.49 → 0.7.51

package/README.md

@@ -239,15 +239,18 @@ appears only after a picker, tab, login stub, storage seed, form fill,
 transport control, or other bounded interaction. Supported setup actions are
 `click`, `fill`, `set_input_value`, `assert_text_visible`,
 `assert_text_absent`, `assert_selector_count`, `local_storage`,
-`session_storage`, `clear_storage`, `wait`, `wait_for_selector`, and
-`wait_for_text`; a failed setup action is recorded as a failed
+`session_storage`, `clear_storage`, `wait`, `wait_for_selector`,
+`wait_for_text`, and `window_call`; a failed setup action is recorded as a failed
 `setup_actions_succeeded` check so the profile cannot pass without reaching
 the intended state. Text-matched `click` actions prefer visible matching
 elements, which keeps responsive layouts from selecting hidden desktop or
-mobile-only links. Use setup assertions when the pre-click or pre-navigation
-state is part of the contract, for example a fresh row must be present, stale
-copy must be absent, or exactly one source link must exist before clicking into
-the final route. `assert_selector_count` accepts `expected_count`.
+mobile-only links. Add `force: true` to a click action only when the matched
+visible element is intentionally animated or otherwise never becomes stable
+enough for Playwright's default click actionability checks. Use setup
+assertions when the pre-click or pre-navigation state is part of the contract,
+for example a fresh row must be present, stale copy must be absent, or exactly
+one source link must exist before clicking into the final route.
+`assert_selector_count` accepts `expected_count`.
 `local_storage` and `session_storage` accept a `key` plus string `value` or
 JSON `json` / `value_json`, and can reload the page with `reload: true`.
 `clear_storage` clears `local`, `session`, or `both` browser storage scopes,

package/dist/{chunk-Q3X6UTPP.js → chunk-ZC4C52ZC.js}

@@ -40,7 +40,8 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "clear_storage",
   "wait",
   "wait_for_selector",
-  "wait_for_text"
+  "wait_for_text",
+  "window_call"
 ];
 var DEFAULT_VIEWPORTS = [
   { name: "desktop", width: 1280, height: 800 }
@@ -63,6 +64,12 @@ function stringFromOwn(input, ...keys) {
   }
   return void 0;
 }
+function valueFromOwn(input, ...keys) {
+  for (const key of keys) {
+    if (hasOwn(input, key)) return input[key];
+  }
+  return void 0;
+}
 function numberValue(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
@@ -204,6 +211,14 @@ function normalizeSetupActionStorage(value, index) {
   if (normalized === "both" || normalized === "all") return "both";
   throw new Error(`target.setup_actions[${index}].storage ${String(value)} is not supported. Supported storage values: local, session, both.`);
 }
+function normalizeSetupActionArgs(input, index) {
+  const argsInput = valueFromOwn(input, "args", "arguments", "args_json", "argsJson");
+  if (argsInput === void 0) return void 0;
+  if (!Array.isArray(argsInput)) {
+    throw new Error(`target.setup_actions[${index}] window_call args must be an array.`);
+  }
+  return argsInput.map(toJsonValue);
+}
 function normalizeSetupAction(input, index) {
   if (!isRecord(input)) throw new Error(`target.setup_actions[${index}] must be an object.`);
   const type = normalizeSetupActionType(stringValue(input.type), index);
@@ -233,12 +248,22 @@ function normalizeSetupAction(input, index) {
   if ((type === "local_storage" || type === "session_storage") && value === void 0 && !hasJsonValue) {
     throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
+  const path = stringFromOwn(input, "path", "function_path", "functionPath", "window_path", "windowPath");
+  if (type === "window_call" && !path) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires path.`);
+  }
+  const args = type === "window_call" ? normalizeSetupActionArgs(input, index) : void 0;
+  const hasExpectedReturn = hasOwn(input, "expect_return") || hasOwn(input, "expectReturn") || hasOwn(input, "expected_return") || hasOwn(input, "expectedReturn");
   return {
     type,
     selector,
+    force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
     key,
     value,
     value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
+    path,
+    args,
+    expect_return: hasExpectedReturn ? toJsonValue(valueFromOwn(input, "expect_return", "expectReturn", "expected_return", "expectedReturn")) : void 0,
     text: stringValue(input.text),
     pattern: stringValue(input.pattern),
     flags: stringValue(input.flags),
@@ -1939,6 +1964,19 @@ function setupActionValue(action) {
   if (setupHasOwn(action, "value")) return String(action.value ?? "");
   return "";
 }
+function setupJsonValue(value) {
+  if (value === null || value === undefined) return null;
+  if (typeof value === "string" || typeof value === "boolean") return value;
+  if (typeof value === "number") return Number.isFinite(value) ? value : null;
+  if (Array.isArray(value)) return value.map(setupJsonValue);
+  if (typeof value === "object") {
+    return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, setupJsonValue(child)]));
+  }
+  return String(value);
+}
+function setupValuesEqual(left, right) {
+  return JSON.stringify(setupJsonValue(left)) === JSON.stringify(setupJsonValue(right));
+}
 async function setupLocatorText(locator, index) {
   return await locator.nth(index).textContent({ timeout: 1000 }).catch(() => "");
 }
@@ -2134,6 +2172,59 @@ async function executeSetupAction(action, ordinal) {
       }
       return { ...base, ok: true, storage, reload: action.reload === true };
     }
+    if (type === "window_call") {
+      const path = String(action.path || action.function_path || action.functionPath || "");
+      const args = Array.isArray(action.args) ? action.args : [];
+      if (!path) return { ...base, path, reason: "missing_path" };
+      const result = await page.evaluate(async ({ path, args }) => {
+        const toJsonValue = (value) => {
+          if (value === null || value === undefined) return null;
+          if (typeof value === "string" || typeof value === "boolean") return value;
+          if (typeof value === "number") return Number.isFinite(value) ? value : null;
+          if (Array.isArray(value)) return value.map(toJsonValue);
+          if (typeof value === "object") {
+            return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, toJsonValue(child)]));
+          }
+          return String(value);
+        };
+        const pathParts = String(path || "").split(".").map((part) => part.trim()).filter(Boolean);
+        let parent = window;
+        let current = window;
+        for (const part of pathParts) {
+          parent = current;
+          current = current?.[part];
+        }
+        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) };
+        } catch (error) {
+          return { ok: false, reason: "function_threw", error: String(error && error.message ? error.message : error).slice(0, 1000) };
+        }
+      }, { path, args });
+      const hasExpectation = setupHasOwn(action, "expect_return")
+        || setupHasOwn(action, "expectReturn")
+        || setupHasOwn(action, "expected_return")
+        || setupHasOwn(action, "expectedReturn");
+      const expected = setupHasOwn(action, "expect_return")
+        ? action.expect_return
+        : setupHasOwn(action, "expectReturn")
+          ? action.expectReturn
+          : setupHasOwn(action, "expected_return")
+            ? action.expected_return
+            : action.expectedReturn;
+      const expectationMet = !hasExpectation || setupValuesEqual(result.returned, expected);
+      return {
+        ...base,
+        ok: Boolean(result.ok && expectationMet),
+        path,
+        arg_count: args.length,
+        returned: setupJsonValue(result.returned),
+        expected_return: hasExpectation ? setupJsonValue(expected) : undefined,
+        reason: result.ok ? (expectationMet ? undefined : "unexpected_return_value") : result.reason,
+        error: result.error || undefined,
+      };
+    }
     if (type === "click") {
       const locator = page.locator(action.selector);
       const count = await locator.count();
@@ -2163,8 +2254,11 @@ async function executeSetupAction(action, ordinal) {
         if (targetIndex < 0) return { ...base, reason: "text_not_found", count };
       }
       if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex };
-      await locator.nth(targetIndex).click({ timeout, noWaitAfter: true });
-      return { ...base, ok: true, count, target_index: targetIndex, text: matchedText };
+      const clickOptions = action.force === true
+        ? { timeout, noWaitAfter: true, force: true }
+        : { timeout, noWaitAfter: true };
+      await locator.nth(targetIndex).click(clickOptions);
+      return { ...base, ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined };
     }
     if (type === "fill" || type === "set_input_value") {
       const locator = page.locator(action.selector);

package/dist/cli.cjs

@@ -6913,7 +6913,8 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "clear_storage",
   "wait",
   "wait_for_selector",
-  "wait_for_text"
+  "wait_for_text",
+  "window_call"
 ];
 var DEFAULT_VIEWPORTS = [
   { name: "desktop", width: 1280, height: 800 }
@@ -6936,6 +6937,12 @@ function stringFromOwn(input, ...keys) {
   }
   return void 0;
 }
+function valueFromOwn(input, ...keys) {
+  for (const key of keys) {
+    if (hasOwn(input, key)) return input[key];
+  }
+  return void 0;
+}
 function numberValue(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
@@ -7077,6 +7084,14 @@ function normalizeSetupActionStorage(value, index) {
   if (normalized === "both" || normalized === "all") return "both";
   throw new Error(`target.setup_actions[${index}].storage ${String(value)} is not supported. Supported storage values: local, session, both.`);
 }
+function normalizeSetupActionArgs(input, index) {
+  const argsInput = valueFromOwn(input, "args", "arguments", "args_json", "argsJson");
+  if (argsInput === void 0) return void 0;
+  if (!Array.isArray(argsInput)) {
+    throw new Error(`target.setup_actions[${index}] window_call args must be an array.`);
+  }
+  return argsInput.map(toJsonValue);
+}
 function normalizeSetupAction(input, index) {
   if (!isRecord(input)) throw new Error(`target.setup_actions[${index}] must be an object.`);
   const type = normalizeSetupActionType(stringValue2(input.type), index);
@@ -7106,12 +7121,22 @@ function normalizeSetupAction(input, index) {
   if ((type === "local_storage" || type === "session_storage") && value === void 0 && !hasJsonValue) {
     throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
+  const path7 = stringFromOwn(input, "path", "function_path", "functionPath", "window_path", "windowPath");
+  if (type === "window_call" && !path7) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires path.`);
+  }
+  const args = type === "window_call" ? normalizeSetupActionArgs(input, index) : void 0;
+  const hasExpectedReturn = hasOwn(input, "expect_return") || hasOwn(input, "expectReturn") || hasOwn(input, "expected_return") || hasOwn(input, "expectedReturn");
   return {
     type,
     selector,
+    force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
     key,
     value,
     value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
+    path: path7,
+    args,
+    expect_return: hasExpectedReturn ? toJsonValue(valueFromOwn(input, "expect_return", "expectReturn", "expected_return", "expectedReturn")) : void 0,
     text: stringValue2(input.text),
     pattern: stringValue2(input.pattern),
     flags: stringValue2(input.flags),
@@ -8796,6 +8821,19 @@ function setupActionValue(action) {
   if (setupHasOwn(action, "value")) return String(action.value ?? "");
   return "";
 }
+function setupJsonValue(value) {
+  if (value === null || value === undefined) return null;
+  if (typeof value === "string" || typeof value === "boolean") return value;
+  if (typeof value === "number") return Number.isFinite(value) ? value : null;
+  if (Array.isArray(value)) return value.map(setupJsonValue);
+  if (typeof value === "object") {
+    return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, setupJsonValue(child)]));
+  }
+  return String(value);
+}
+function setupValuesEqual(left, right) {
+  return JSON.stringify(setupJsonValue(left)) === JSON.stringify(setupJsonValue(right));
+}
 async function setupLocatorText(locator, index) {
   return await locator.nth(index).textContent({ timeout: 1000 }).catch(() => "");
 }
@@ -8991,6 +9029,59 @@ async function executeSetupAction(action, ordinal) {
       }
       return { ...base, ok: true, storage, reload: action.reload === true };
     }
+    if (type === "window_call") {
+      const path = String(action.path || action.function_path || action.functionPath || "");
+      const args = Array.isArray(action.args) ? action.args : [];
+      if (!path) return { ...base, path, reason: "missing_path" };
+      const result = await page.evaluate(async ({ path, args }) => {
+        const toJsonValue = (value) => {
+          if (value === null || value === undefined) return null;
+          if (typeof value === "string" || typeof value === "boolean") return value;
+          if (typeof value === "number") return Number.isFinite(value) ? value : null;
+          if (Array.isArray(value)) return value.map(toJsonValue);
+          if (typeof value === "object") {
+            return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, toJsonValue(child)]));
+          }
+          return String(value);
+        };
+        const pathParts = String(path || "").split(".").map((part) => part.trim()).filter(Boolean);
+        let parent = window;
+        let current = window;
+        for (const part of pathParts) {
+          parent = current;
+          current = current?.[part];
+        }
+        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) };
+        } catch (error) {
+          return { ok: false, reason: "function_threw", error: String(error && error.message ? error.message : error).slice(0, 1000) };
+        }
+      }, { path, args });
+      const hasExpectation = setupHasOwn(action, "expect_return")
+        || setupHasOwn(action, "expectReturn")
+        || setupHasOwn(action, "expected_return")
+        || setupHasOwn(action, "expectedReturn");
+      const expected = setupHasOwn(action, "expect_return")
+        ? action.expect_return
+        : setupHasOwn(action, "expectReturn")
+          ? action.expectReturn
+          : setupHasOwn(action, "expected_return")
+            ? action.expected_return
+            : action.expectedReturn;
+      const expectationMet = !hasExpectation || setupValuesEqual(result.returned, expected);
+      return {
+        ...base,
+        ok: Boolean(result.ok && expectationMet),
+        path,
+        arg_count: args.length,
+        returned: setupJsonValue(result.returned),
+        expected_return: hasExpectation ? setupJsonValue(expected) : undefined,
+        reason: result.ok ? (expectationMet ? undefined : "unexpected_return_value") : result.reason,
+        error: result.error || undefined,
+      };
+    }
     if (type === "click") {
       const locator = page.locator(action.selector);
       const count = await locator.count();
@@ -9020,8 +9111,11 @@ async function executeSetupAction(action, ordinal) {
         if (targetIndex < 0) return { ...base, reason: "text_not_found", count };
       }
       if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex };
-      await locator.nth(targetIndex).click({ timeout, noWaitAfter: true });
-      return { ...base, ok: true, count, target_index: targetIndex, text: matchedText };
+      const clickOptions = action.force === true
+        ? { timeout, noWaitAfter: true, force: true }
+        : { timeout, noWaitAfter: true };
+      await locator.nth(targetIndex).click(clickOptions);
+      return { ...base, ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined };
     }
     if (type === "fill" || type === "set_input_value") {
       const locator = page.locator(action.selector);

package/dist/cli.js

@@ -10,7 +10,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-Q3X6UTPP.js";
+} from "./chunk-ZC4C52ZC.js";
 import {
   createRiddleApiClient,
   parseRiddleViewport

package/dist/index.cjs

@@ -8754,7 +8754,8 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "clear_storage",
   "wait",
   "wait_for_selector",
-  "wait_for_text"
+  "wait_for_text",
+  "window_call"
 ];
 var DEFAULT_VIEWPORTS = [
   { name: "desktop", width: 1280, height: 800 }
@@ -8777,6 +8778,12 @@ function stringFromOwn(input, ...keys) {
   }
   return void 0;
 }
+function valueFromOwn(input, ...keys) {
+  for (const key of keys) {
+    if (hasOwn(input, key)) return input[key];
+  }
+  return void 0;
+}
 function numberValue3(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
@@ -8918,6 +8925,14 @@ function normalizeSetupActionStorage(value, index) {
   if (normalized === "both" || normalized === "all") return "both";
   throw new Error(`target.setup_actions[${index}].storage ${String(value)} is not supported. Supported storage values: local, session, both.`);
 }
+function normalizeSetupActionArgs(input, index) {
+  const argsInput = valueFromOwn(input, "args", "arguments", "args_json", "argsJson");
+  if (argsInput === void 0) return void 0;
+  if (!Array.isArray(argsInput)) {
+    throw new Error(`target.setup_actions[${index}] window_call args must be an array.`);
+  }
+  return argsInput.map(toJsonValue);
+}
 function normalizeSetupAction(input, index) {
   if (!isRecord2(input)) throw new Error(`target.setup_actions[${index}] must be an object.`);
   const type = normalizeSetupActionType(stringValue5(input.type), index);
@@ -8947,12 +8962,22 @@ function normalizeSetupAction(input, index) {
   if ((type === "local_storage" || type === "session_storage") && value === void 0 && !hasJsonValue) {
     throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
+  const path6 = stringFromOwn(input, "path", "function_path", "functionPath", "window_path", "windowPath");
+  if (type === "window_call" && !path6) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires path.`);
+  }
+  const args = type === "window_call" ? normalizeSetupActionArgs(input, index) : void 0;
+  const hasExpectedReturn = hasOwn(input, "expect_return") || hasOwn(input, "expectReturn") || hasOwn(input, "expected_return") || hasOwn(input, "expectedReturn");
   return {
     type,
     selector,
+    force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
     key,
     value,
     value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
+    path: path6,
+    args,
+    expect_return: hasExpectedReturn ? toJsonValue(valueFromOwn(input, "expect_return", "expectReturn", "expected_return", "expectedReturn")) : void 0,
     text: stringValue5(input.text),
     pattern: stringValue5(input.pattern),
     flags: stringValue5(input.flags),
@@ -10653,6 +10678,19 @@ function setupActionValue(action) {
   if (setupHasOwn(action, "value")) return String(action.value ?? "");
   return "";
 }
+function setupJsonValue(value) {
+  if (value === null || value === undefined) return null;
+  if (typeof value === "string" || typeof value === "boolean") return value;
+  if (typeof value === "number") return Number.isFinite(value) ? value : null;
+  if (Array.isArray(value)) return value.map(setupJsonValue);
+  if (typeof value === "object") {
+    return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, setupJsonValue(child)]));
+  }
+  return String(value);
+}
+function setupValuesEqual(left, right) {
+  return JSON.stringify(setupJsonValue(left)) === JSON.stringify(setupJsonValue(right));
+}
 async function setupLocatorText(locator, index) {
   return await locator.nth(index).textContent({ timeout: 1000 }).catch(() => "");
 }
@@ -10848,6 +10886,59 @@ async function executeSetupAction(action, ordinal) {
       }
       return { ...base, ok: true, storage, reload: action.reload === true };
     }
+    if (type === "window_call") {
+      const path = String(action.path || action.function_path || action.functionPath || "");
+      const args = Array.isArray(action.args) ? action.args : [];
+      if (!path) return { ...base, path, reason: "missing_path" };
+      const result = await page.evaluate(async ({ path, args }) => {
+        const toJsonValue = (value) => {
+          if (value === null || value === undefined) return null;
+          if (typeof value === "string" || typeof value === "boolean") return value;
+          if (typeof value === "number") return Number.isFinite(value) ? value : null;
+          if (Array.isArray(value)) return value.map(toJsonValue);
+          if (typeof value === "object") {
+            return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, toJsonValue(child)]));
+          }
+          return String(value);
+        };
+        const pathParts = String(path || "").split(".").map((part) => part.trim()).filter(Boolean);
+        let parent = window;
+        let current = window;
+        for (const part of pathParts) {
+          parent = current;
+          current = current?.[part];
+        }
+        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) };
+        } catch (error) {
+          return { ok: false, reason: "function_threw", error: String(error && error.message ? error.message : error).slice(0, 1000) };
+        }
+      }, { path, args });
+      const hasExpectation = setupHasOwn(action, "expect_return")
+        || setupHasOwn(action, "expectReturn")
+        || setupHasOwn(action, "expected_return")
+        || setupHasOwn(action, "expectedReturn");
+      const expected = setupHasOwn(action, "expect_return")
+        ? action.expect_return
+        : setupHasOwn(action, "expectReturn")
+          ? action.expectReturn
+          : setupHasOwn(action, "expected_return")
+            ? action.expected_return
+            : action.expectedReturn;
+      const expectationMet = !hasExpectation || setupValuesEqual(result.returned, expected);
+      return {
+        ...base,
+        ok: Boolean(result.ok && expectationMet),
+        path,
+        arg_count: args.length,
+        returned: setupJsonValue(result.returned),
+        expected_return: hasExpectation ? setupJsonValue(expected) : undefined,
+        reason: result.ok ? (expectationMet ? undefined : "unexpected_return_value") : result.reason,
+        error: result.error || undefined,
+      };
+    }
     if (type === "click") {
       const locator = page.locator(action.selector);
       const count = await locator.count();
@@ -10877,8 +10968,11 @@ async function executeSetupAction(action, ordinal) {
         if (targetIndex < 0) return { ...base, reason: "text_not_found", count };
       }
       if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex };
-      await locator.nth(targetIndex).click({ timeout, noWaitAfter: true });
-      return { ...base, ok: true, count, target_index: targetIndex, text: matchedText };
+      const clickOptions = action.force === true
+        ? { timeout, noWaitAfter: true, force: true }
+        : { timeout, noWaitAfter: true };
+      await locator.nth(targetIndex).click(clickOptions);
+      return { ...base, ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined };
     }
     if (type === "fill" || type === "set_input_value") {
       const locator = page.locator(action.selector);

package/dist/index.js

@@ -58,7 +58,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-Q3X6UTPP.js";
+} from "./chunk-ZC4C52ZC.js";
 import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,

package/dist/profile.cjs

@@ -83,7 +83,8 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "clear_storage",
   "wait",
   "wait_for_selector",
-  "wait_for_text"
+  "wait_for_text",
+  "window_call"
 ];
 var DEFAULT_VIEWPORTS = [
   { name: "desktop", width: 1280, height: 800 }
@@ -106,6 +107,12 @@ function stringFromOwn(input, ...keys) {
   }
   return void 0;
 }
+function valueFromOwn(input, ...keys) {
+  for (const key of keys) {
+    if (hasOwn(input, key)) return input[key];
+  }
+  return void 0;
+}
 function numberValue(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
@@ -247,6 +254,14 @@ function normalizeSetupActionStorage(value, index) {
   if (normalized === "both" || normalized === "all") return "both";
   throw new Error(`target.setup_actions[${index}].storage ${String(value)} is not supported. Supported storage values: local, session, both.`);
 }
+function normalizeSetupActionArgs(input, index) {
+  const argsInput = valueFromOwn(input, "args", "arguments", "args_json", "argsJson");
+  if (argsInput === void 0) return void 0;
+  if (!Array.isArray(argsInput)) {
+    throw new Error(`target.setup_actions[${index}] window_call args must be an array.`);
+  }
+  return argsInput.map(toJsonValue);
+}
 function normalizeSetupAction(input, index) {
   if (!isRecord(input)) throw new Error(`target.setup_actions[${index}] must be an object.`);
   const type = normalizeSetupActionType(stringValue(input.type), index);
@@ -276,12 +291,22 @@ function normalizeSetupAction(input, index) {
   if ((type === "local_storage" || type === "session_storage") && value === void 0 && !hasJsonValue) {
     throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
+  const path = stringFromOwn(input, "path", "function_path", "functionPath", "window_path", "windowPath");
+  if (type === "window_call" && !path) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires path.`);
+  }
+  const args = type === "window_call" ? normalizeSetupActionArgs(input, index) : void 0;
+  const hasExpectedReturn = hasOwn(input, "expect_return") || hasOwn(input, "expectReturn") || hasOwn(input, "expected_return") || hasOwn(input, "expectedReturn");
   return {
     type,
     selector,
+    force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
     key,
     value,
     value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
+    path,
+    args,
+    expect_return: hasExpectedReturn ? toJsonValue(valueFromOwn(input, "expect_return", "expectReturn", "expected_return", "expectedReturn")) : void 0,
     text: stringValue(input.text),
     pattern: stringValue(input.pattern),
     flags: stringValue(input.flags),
@@ -1982,6 +2007,19 @@ function setupActionValue(action) {
   if (setupHasOwn(action, "value")) return String(action.value ?? "");
   return "";
 }
+function setupJsonValue(value) {
+  if (value === null || value === undefined) return null;
+  if (typeof value === "string" || typeof value === "boolean") return value;
+  if (typeof value === "number") return Number.isFinite(value) ? value : null;
+  if (Array.isArray(value)) return value.map(setupJsonValue);
+  if (typeof value === "object") {
+    return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, setupJsonValue(child)]));
+  }
+  return String(value);
+}
+function setupValuesEqual(left, right) {
+  return JSON.stringify(setupJsonValue(left)) === JSON.stringify(setupJsonValue(right));
+}
 async function setupLocatorText(locator, index) {
   return await locator.nth(index).textContent({ timeout: 1000 }).catch(() => "");
 }
@@ -2177,6 +2215,59 @@ async function executeSetupAction(action, ordinal) {
       }
       return { ...base, ok: true, storage, reload: action.reload === true };
     }
+    if (type === "window_call") {
+      const path = String(action.path || action.function_path || action.functionPath || "");
+      const args = Array.isArray(action.args) ? action.args : [];
+      if (!path) return { ...base, path, reason: "missing_path" };
+      const result = await page.evaluate(async ({ path, args }) => {
+        const toJsonValue = (value) => {
+          if (value === null || value === undefined) return null;
+          if (typeof value === "string" || typeof value === "boolean") return value;
+          if (typeof value === "number") return Number.isFinite(value) ? value : null;
+          if (Array.isArray(value)) return value.map(toJsonValue);
+          if (typeof value === "object") {
+            return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, toJsonValue(child)]));
+          }
+          return String(value);
+        };
+        const pathParts = String(path || "").split(".").map((part) => part.trim()).filter(Boolean);
+        let parent = window;
+        let current = window;
+        for (const part of pathParts) {
+          parent = current;
+          current = current?.[part];
+        }
+        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) };
+        } catch (error) {
+          return { ok: false, reason: "function_threw", error: String(error && error.message ? error.message : error).slice(0, 1000) };
+        }
+      }, { path, args });
+      const hasExpectation = setupHasOwn(action, "expect_return")
+        || setupHasOwn(action, "expectReturn")
+        || setupHasOwn(action, "expected_return")
+        || setupHasOwn(action, "expectedReturn");
+      const expected = setupHasOwn(action, "expect_return")
+        ? action.expect_return
+        : setupHasOwn(action, "expectReturn")
+          ? action.expectReturn
+          : setupHasOwn(action, "expected_return")
+            ? action.expected_return
+            : action.expectedReturn;
+      const expectationMet = !hasExpectation || setupValuesEqual(result.returned, expected);
+      return {
+        ...base,
+        ok: Boolean(result.ok && expectationMet),
+        path,
+        arg_count: args.length,
+        returned: setupJsonValue(result.returned),
+        expected_return: hasExpectation ? setupJsonValue(expected) : undefined,
+        reason: result.ok ? (expectationMet ? undefined : "unexpected_return_value") : result.reason,
+        error: result.error || undefined,
+      };
+    }
     if (type === "click") {
       const locator = page.locator(action.selector);
       const count = await locator.count();
@@ -2206,8 +2297,11 @@ async function executeSetupAction(action, ordinal) {
         if (targetIndex < 0) return { ...base, reason: "text_not_found", count };
       }
       if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex };
-      await locator.nth(targetIndex).click({ timeout, noWaitAfter: true });
-      return { ...base, ok: true, count, target_index: targetIndex, text: matchedText };
+      const clickOptions = action.force === true
+        ? { timeout, noWaitAfter: true, force: true }
+        : { timeout, noWaitAfter: true };
+      await locator.nth(targetIndex).click(clickOptions);
+      return { ...base, ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined };
     }
     if (type === "fill" || type === "set_input_value") {
       const locator = page.locator(action.selector);

package/dist/profile.d.cts

@@ -5,7 +5,7 @@ declare const RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION: "riddle-proof.profile-evide
 declare const RIDDLE_PROOF_PROFILE_RESULT_VERSION: "riddle-proof.profile-result.v1";
 declare const RIDDLE_PROOF_PROFILE_STATUSES: readonly ["passed", "product_regression", "proof_insufficient", "environment_blocked", "configuration_error", "needs_human_review"];
 declare const RIDDLE_PROOF_PROFILE_CHECK_TYPES: readonly ["route_loaded", "selector_visible", "selector_absent", "selector_count_at_least", "selector_count_equals", "selector_count_equal", "selector_count_eq", "selector_text_order", "frame_text_visible", "frame_no_horizontal_overflow", "text_visible", "text_absent", "route_inventory", "no_horizontal_overflow", "no_mobile_horizontal_overflow", "no_fatal_console_errors"];
-declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "fill", "set_input_value", "assert_text_visible", "assert_text_absent", "assert_selector_count", "local_storage", "session_storage", "clear_storage", "wait", "wait_for_selector", "wait_for_text"];
+declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "fill", "set_input_value", "assert_text_visible", "assert_text_absent", "assert_selector_count", "local_storage", "session_storage", "clear_storage", "wait", "wait_for_selector", "wait_for_text", "window_call"];
 type RiddleProofProfileStatus = typeof RIDDLE_PROOF_PROFILE_STATUSES[number];
 type RiddleProofProfileCheckType = typeof RIDDLE_PROOF_PROFILE_CHECK_TYPES[number];
 type RiddleProofProfileSetupActionType = typeof RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES[number];
@@ -20,9 +20,13 @@ interface RiddleProofProfileViewport {
 interface RiddleProofProfileSetupAction {
     type: RiddleProofProfileSetupActionType;
     selector?: string;
+    force?: boolean;
     key?: string;
     value?: string;
     value_json?: JsonValue;
+    path?: string;
+    args?: JsonValue[];
+    expect_return?: JsonValue;
     text?: string;
     pattern?: string;
     flags?: string;

package/dist/profile.d.ts

@@ -5,7 +5,7 @@ declare const RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION: "riddle-proof.profile-evide
 declare const RIDDLE_PROOF_PROFILE_RESULT_VERSION: "riddle-proof.profile-result.v1";
 declare const RIDDLE_PROOF_PROFILE_STATUSES: readonly ["passed", "product_regression", "proof_insufficient", "environment_blocked", "configuration_error", "needs_human_review"];
 declare const RIDDLE_PROOF_PROFILE_CHECK_TYPES: readonly ["route_loaded", "selector_visible", "selector_absent", "selector_count_at_least", "selector_count_equals", "selector_count_equal", "selector_count_eq", "selector_text_order", "frame_text_visible", "frame_no_horizontal_overflow", "text_visible", "text_absent", "route_inventory", "no_horizontal_overflow", "no_mobile_horizontal_overflow", "no_fatal_console_errors"];
-declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "fill", "set_input_value", "assert_text_visible", "assert_text_absent", "assert_selector_count", "local_storage", "session_storage", "clear_storage", "wait", "wait_for_selector", "wait_for_text"];
+declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "fill", "set_input_value", "assert_text_visible", "assert_text_absent", "assert_selector_count", "local_storage", "session_storage", "clear_storage", "wait", "wait_for_selector", "wait_for_text", "window_call"];
 type RiddleProofProfileStatus = typeof RIDDLE_PROOF_PROFILE_STATUSES[number];
 type RiddleProofProfileCheckType = typeof RIDDLE_PROOF_PROFILE_CHECK_TYPES[number];
 type RiddleProofProfileSetupActionType = typeof RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES[number];
@@ -20,9 +20,13 @@ interface RiddleProofProfileViewport {
 interface RiddleProofProfileSetupAction {
     type: RiddleProofProfileSetupActionType;
     selector?: string;
+    force?: boolean;
     key?: string;
     value?: string;
     value_json?: JsonValue;
+    path?: string;
+    args?: JsonValue[];
+    expect_return?: JsonValue;
     text?: string;
     pattern?: string;
     flags?: string;

package/dist/profile.js

@@ -19,7 +19,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-Q3X6UTPP.js";
+} from "./chunk-ZC4C52ZC.js";
 export {
   RIDDLE_PROOF_PROFILE_CHECK_TYPES,
   RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,

package/dist/proof-run-engine.d.cts

@@ -292,7 +292,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     blocking?: boolean;
     details?: Record<string, unknown>;
     ok: boolean;
-    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
     state_path: string;
     stage: any;
     summary: string;
@@ -382,7 +382,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     continueWithStage?: WorkflowStage | null;
     blocking?: boolean;
     details?: Record<string, unknown>;
-    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
     state_path: string;
     stage: any;
     checkpoint: string;
@@ -659,7 +659,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     error?: undefined;
 } | {
     ok: boolean;
-    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
     state_path: string;
     stage: any;
     summary: string;

package/dist/proof-run-engine.d.ts

@@ -292,7 +292,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     blocking?: boolean;
     details?: Record<string, unknown>;
     ok: boolean;
-    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
     state_path: string;
     stage: any;
     summary: string;
@@ -382,7 +382,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     continueWithStage?: WorkflowStage | null;
     blocking?: boolean;
     details?: Record<string, unknown>;
-    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
     state_path: string;
     stage: any;
     checkpoint: string;
@@ -659,7 +659,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     error?: undefined;
 } | {
     ok: boolean;
-    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
     state_path: string;
     stage: any;
     summary: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riddledc/riddle-proof",
-  "version": "0.7.49",
+  "version": "0.7.51",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",