@riddledc/riddle-proof 0.7.29 → 0.7.31

package/README.md

@@ -122,6 +122,11 @@ or as a stronger proof base before a change loop.
       }
     ],
     "setup_actions": [
+      {
+        "type": "clear_storage",
+        "storage": "both",
+        "reload": true
+      },
       {
         "type": "local_storage",
         "key": "demo-auth",
@@ -178,13 +183,16 @@ best-effort mocks.
 `target.setup_actions` is optional. Use it when the meaningful proof surface
 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`, `local_storage`, `wait`,
-`wait_for_selector`, and `wait_for_text`; 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. `local_storage` accepts a `key` plus string `value` or
-JSON `json` / `value_json`, and can reload the page with `reload: true`.
+`click`, `fill`, `set_input_value`, `local_storage`, `session_storage`,
+`clear_storage`, `wait`, `wait_for_selector`, and `wait_for_text`; 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. `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, defaults to
+`both`, and can also reload with `reload: true`.
 
 `target.timeout_sec` is optional. Use it for known-heavy profile targets so the
 profile carries its own hosted Riddle worker budget; an explicit CLI `--timeout`

package/dist/{chunk-NUGGW7NX.js → chunk-2NWVXT4Q.js}

@@ -25,6 +25,8 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "fill",
   "set_input_value",
   "local_storage",
+  "session_storage",
+  "clear_storage",
   "wait",
   "wait_for_selector",
   "wait_for_text"
@@ -176,12 +178,21 @@ function isSupportedCheckType(value) {
   return RIDDLE_PROOF_PROFILE_CHECK_TYPES.includes(value);
 }
 function normalizeSetupActionType(value, index) {
-  const normalized = String(value || "").trim().replace(/-/g, "_");
+  const normalizedInput = String(value || "").trim().replace(/-/g, "_");
+  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput;
   if (RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.includes(normalized)) {
     return normalized;
   }
   throw new Error(`target.setup_actions[${index}].type ${value || "(missing)"} is not supported. Supported actions: ${RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.join(", ")}`);
 }
+function normalizeSetupActionStorage(value, index) {
+  if (value === void 0 || value === null || value === "") return void 0;
+  const normalized = String(value).trim().replace(/-/g, "_");
+  if (normalized === "local" || normalized === "local_storage") return "local";
+  if (normalized === "session" || normalized === "session_storage") return "session";
+  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 normalizeSetupAction(input, index) {
   if (!isRecord(input)) throw new Error(`target.setup_actions[${index}] must be an object.`);
   const type = normalizeSetupActionType(stringValue(input.type), index);
@@ -198,11 +209,11 @@ function normalizeSetupAction(input, index) {
     throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
   const key = stringValue(input.key);
-  if (type === "local_storage" && !key) {
-    throw new Error(`target.setup_actions[${index}] local_storage requires key.`);
+  if ((type === "local_storage" || type === "session_storage") && !key) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires key.`);
   }
-  if (type === "local_storage" && value === void 0 && !hasJsonValue) {
-    throw new Error(`target.setup_actions[${index}] local_storage requires value.`);
+  if ((type === "local_storage" || type === "session_storage") && value === void 0 && !hasJsonValue) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
   return {
     type,
@@ -218,6 +229,7 @@ function normalizeSetupAction(input, index) {
     timeout_ms: numberValue(input.timeout_ms) ?? numberValue(input.timeoutMs),
     after_ms: numberValue(input.after_ms) ?? numberValue(input.afterMs),
     reload: input.reload === true,
+    storage: normalizeSetupActionStorage(input.storage, index),
     continue_on_failure: input.continue_on_failure === true || input.continueOnFailure === true
   };
 }
@@ -1214,16 +1226,28 @@ async function executeSetupAction(action, ordinal) {
       await page.waitForSelector(action.selector, { state: "visible", timeout });
       return { ...base, ok: true, timeout_ms: timeout };
     }
-    if (type === "local_storage") {
+    if (type === "local_storage" || type === "session_storage") {
       const value = setupActionValue(action);
-      await page.evaluate(({ key, value }) => {
-        window.localStorage.setItem(key, value);
-      }, { key: action.key, value });
+      await page.evaluate(({ type, key, value }) => {
+        const storage = type === "session_storage" ? window.sessionStorage : window.localStorage;
+        storage.setItem(key, value);
+      }, { type, key: action.key, value });
       if (action.reload === true) {
         await page.reload({ waitUntil: "domcontentloaded", timeout: 45000 });
       }
       return { ...base, ok: true, key: action.key, value_length: value.length, reload: action.reload === true };
     }
+    if (type === "clear_storage") {
+      const storage = action.storage || "both";
+      await page.evaluate(({ storage }) => {
+        if (storage === "local" || storage === "both") window.localStorage.clear();
+        if (storage === "session" || storage === "both") window.sessionStorage.clear();
+      }, { storage });
+      if (action.reload === true) {
+        await page.reload({ waitUntil: "domcontentloaded", timeout: 45000 });
+      }
+      return { ...base, ok: true, storage, reload: action.reload === true };
+    }
     if (type === "click") {
       const locator = page.locator(action.selector);
       const count = await locator.count();
@@ -1253,7 +1277,7 @@ 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 });
+      await locator.nth(targetIndex).click({ timeout, noWaitAfter: true });
       return { ...base, ok: true, count, target_index: targetIndex, text: matchedText };
     }
     if (type === "fill" || type === "set_input_value") {

package/dist/cli.cjs

@@ -6898,6 +6898,8 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "fill",
   "set_input_value",
   "local_storage",
+  "session_storage",
+  "clear_storage",
   "wait",
   "wait_for_selector",
   "wait_for_text"
@@ -7049,12 +7051,21 @@ function isSupportedCheckType(value) {
   return RIDDLE_PROOF_PROFILE_CHECK_TYPES.includes(value);
 }
 function normalizeSetupActionType(value, index) {
-  const normalized = String(value || "").trim().replace(/-/g, "_");
+  const normalizedInput = String(value || "").trim().replace(/-/g, "_");
+  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput;
   if (RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.includes(normalized)) {
     return normalized;
   }
   throw new Error(`target.setup_actions[${index}].type ${value || "(missing)"} is not supported. Supported actions: ${RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.join(", ")}`);
 }
+function normalizeSetupActionStorage(value, index) {
+  if (value === void 0 || value === null || value === "") return void 0;
+  const normalized = String(value).trim().replace(/-/g, "_");
+  if (normalized === "local" || normalized === "local_storage") return "local";
+  if (normalized === "session" || normalized === "session_storage") return "session";
+  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 normalizeSetupAction(input, index) {
   if (!isRecord(input)) throw new Error(`target.setup_actions[${index}] must be an object.`);
   const type = normalizeSetupActionType(stringValue2(input.type), index);
@@ -7071,11 +7082,11 @@ function normalizeSetupAction(input, index) {
     throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
   const key = stringValue2(input.key);
-  if (type === "local_storage" && !key) {
-    throw new Error(`target.setup_actions[${index}] local_storage requires key.`);
+  if ((type === "local_storage" || type === "session_storage") && !key) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires key.`);
   }
-  if (type === "local_storage" && value === void 0 && !hasJsonValue) {
-    throw new Error(`target.setup_actions[${index}] local_storage requires value.`);
+  if ((type === "local_storage" || type === "session_storage") && value === void 0 && !hasJsonValue) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
   return {
     type,
@@ -7091,6 +7102,7 @@ function normalizeSetupAction(input, index) {
     timeout_ms: numberValue(input.timeout_ms) ?? numberValue(input.timeoutMs),
     after_ms: numberValue(input.after_ms) ?? numberValue(input.afterMs),
     reload: input.reload === true,
+    storage: normalizeSetupActionStorage(input.storage, index),
     continue_on_failure: input.continue_on_failure === true || input.continueOnFailure === true
   };
 }
@@ -8071,16 +8083,28 @@ async function executeSetupAction(action, ordinal) {
       await page.waitForSelector(action.selector, { state: "visible", timeout });
       return { ...base, ok: true, timeout_ms: timeout };
     }
-    if (type === "local_storage") {
+    if (type === "local_storage" || type === "session_storage") {
       const value = setupActionValue(action);
-      await page.evaluate(({ key, value }) => {
-        window.localStorage.setItem(key, value);
-      }, { key: action.key, value });
+      await page.evaluate(({ type, key, value }) => {
+        const storage = type === "session_storage" ? window.sessionStorage : window.localStorage;
+        storage.setItem(key, value);
+      }, { type, key: action.key, value });
       if (action.reload === true) {
         await page.reload({ waitUntil: "domcontentloaded", timeout: 45000 });
       }
       return { ...base, ok: true, key: action.key, value_length: value.length, reload: action.reload === true };
     }
+    if (type === "clear_storage") {
+      const storage = action.storage || "both";
+      await page.evaluate(({ storage }) => {
+        if (storage === "local" || storage === "both") window.localStorage.clear();
+        if (storage === "session" || storage === "both") window.sessionStorage.clear();
+      }, { storage });
+      if (action.reload === true) {
+        await page.reload({ waitUntil: "domcontentloaded", timeout: 45000 });
+      }
+      return { ...base, ok: true, storage, reload: action.reload === true };
+    }
     if (type === "click") {
       const locator = page.locator(action.selector);
       const count = await locator.count();
@@ -8110,7 +8134,7 @@ 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 });
+      await locator.nth(targetIndex).click({ timeout, noWaitAfter: true });
       return { ...base, ok: true, count, target_index: targetIndex, text: matchedText };
     }
     if (type === "fill" || type === "set_input_value") {

package/dist/cli.js

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

package/dist/index.cjs

@@ -8739,6 +8739,8 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "fill",
   "set_input_value",
   "local_storage",
+  "session_storage",
+  "clear_storage",
   "wait",
   "wait_for_selector",
   "wait_for_text"
@@ -8890,12 +8892,21 @@ function isSupportedCheckType(value) {
   return RIDDLE_PROOF_PROFILE_CHECK_TYPES.includes(value);
 }
 function normalizeSetupActionType(value, index) {
-  const normalized = String(value || "").trim().replace(/-/g, "_");
+  const normalizedInput = String(value || "").trim().replace(/-/g, "_");
+  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput;
   if (RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.includes(normalized)) {
     return normalized;
   }
   throw new Error(`target.setup_actions[${index}].type ${value || "(missing)"} is not supported. Supported actions: ${RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.join(", ")}`);
 }
+function normalizeSetupActionStorage(value, index) {
+  if (value === void 0 || value === null || value === "") return void 0;
+  const normalized = String(value).trim().replace(/-/g, "_");
+  if (normalized === "local" || normalized === "local_storage") return "local";
+  if (normalized === "session" || normalized === "session_storage") return "session";
+  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 normalizeSetupAction(input, index) {
   if (!isRecord2(input)) throw new Error(`target.setup_actions[${index}] must be an object.`);
   const type = normalizeSetupActionType(stringValue5(input.type), index);
@@ -8912,11 +8923,11 @@ function normalizeSetupAction(input, index) {
     throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
   const key = stringValue5(input.key);
-  if (type === "local_storage" && !key) {
-    throw new Error(`target.setup_actions[${index}] local_storage requires key.`);
+  if ((type === "local_storage" || type === "session_storage") && !key) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires key.`);
   }
-  if (type === "local_storage" && value === void 0 && !hasJsonValue) {
-    throw new Error(`target.setup_actions[${index}] local_storage requires value.`);
+  if ((type === "local_storage" || type === "session_storage") && value === void 0 && !hasJsonValue) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
   return {
     type,
@@ -8932,6 +8943,7 @@ function normalizeSetupAction(input, index) {
     timeout_ms: numberValue3(input.timeout_ms) ?? numberValue3(input.timeoutMs),
     after_ms: numberValue3(input.after_ms) ?? numberValue3(input.afterMs),
     reload: input.reload === true,
+    storage: normalizeSetupActionStorage(input.storage, index),
     continue_on_failure: input.continue_on_failure === true || input.continueOnFailure === true
   };
 }
@@ -9928,16 +9940,28 @@ async function executeSetupAction(action, ordinal) {
       await page.waitForSelector(action.selector, { state: "visible", timeout });
       return { ...base, ok: true, timeout_ms: timeout };
     }
-    if (type === "local_storage") {
+    if (type === "local_storage" || type === "session_storage") {
       const value = setupActionValue(action);
-      await page.evaluate(({ key, value }) => {
-        window.localStorage.setItem(key, value);
-      }, { key: action.key, value });
+      await page.evaluate(({ type, key, value }) => {
+        const storage = type === "session_storage" ? window.sessionStorage : window.localStorage;
+        storage.setItem(key, value);
+      }, { type, key: action.key, value });
       if (action.reload === true) {
         await page.reload({ waitUntil: "domcontentloaded", timeout: 45000 });
       }
       return { ...base, ok: true, key: action.key, value_length: value.length, reload: action.reload === true };
     }
+    if (type === "clear_storage") {
+      const storage = action.storage || "both";
+      await page.evaluate(({ storage }) => {
+        if (storage === "local" || storage === "both") window.localStorage.clear();
+        if (storage === "session" || storage === "both") window.sessionStorage.clear();
+      }, { storage });
+      if (action.reload === true) {
+        await page.reload({ waitUntil: "domcontentloaded", timeout: 45000 });
+      }
+      return { ...base, ok: true, storage, reload: action.reload === true };
+    }
     if (type === "click") {
       const locator = page.locator(action.selector);
       const count = await locator.count();
@@ -9967,7 +9991,7 @@ 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 });
+      await locator.nth(targetIndex).click({ timeout, noWaitAfter: true });
       return { ...base, ok: true, count, target_index: targetIndex, text: matchedText };
     }
     if (type === "fill" || type === "set_input_value") {

package/dist/index.js

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

package/dist/profile.cjs

@@ -68,6 +68,8 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "fill",
   "set_input_value",
   "local_storage",
+  "session_storage",
+  "clear_storage",
   "wait",
   "wait_for_selector",
   "wait_for_text"
@@ -219,12 +221,21 @@ function isSupportedCheckType(value) {
   return RIDDLE_PROOF_PROFILE_CHECK_TYPES.includes(value);
 }
 function normalizeSetupActionType(value, index) {
-  const normalized = String(value || "").trim().replace(/-/g, "_");
+  const normalizedInput = String(value || "").trim().replace(/-/g, "_");
+  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput;
   if (RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.includes(normalized)) {
     return normalized;
   }
   throw new Error(`target.setup_actions[${index}].type ${value || "(missing)"} is not supported. Supported actions: ${RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.join(", ")}`);
 }
+function normalizeSetupActionStorage(value, index) {
+  if (value === void 0 || value === null || value === "") return void 0;
+  const normalized = String(value).trim().replace(/-/g, "_");
+  if (normalized === "local" || normalized === "local_storage") return "local";
+  if (normalized === "session" || normalized === "session_storage") return "session";
+  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 normalizeSetupAction(input, index) {
   if (!isRecord(input)) throw new Error(`target.setup_actions[${index}] must be an object.`);
   const type = normalizeSetupActionType(stringValue(input.type), index);
@@ -241,11 +252,11 @@ function normalizeSetupAction(input, index) {
     throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
   const key = stringValue(input.key);
-  if (type === "local_storage" && !key) {
-    throw new Error(`target.setup_actions[${index}] local_storage requires key.`);
+  if ((type === "local_storage" || type === "session_storage") && !key) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires key.`);
   }
-  if (type === "local_storage" && value === void 0 && !hasJsonValue) {
-    throw new Error(`target.setup_actions[${index}] local_storage requires value.`);
+  if ((type === "local_storage" || type === "session_storage") && value === void 0 && !hasJsonValue) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
   return {
     type,
@@ -261,6 +272,7 @@ function normalizeSetupAction(input, index) {
     timeout_ms: numberValue(input.timeout_ms) ?? numberValue(input.timeoutMs),
     after_ms: numberValue(input.after_ms) ?? numberValue(input.afterMs),
     reload: input.reload === true,
+    storage: normalizeSetupActionStorage(input.storage, index),
     continue_on_failure: input.continue_on_failure === true || input.continueOnFailure === true
   };
 }
@@ -1257,16 +1269,28 @@ async function executeSetupAction(action, ordinal) {
       await page.waitForSelector(action.selector, { state: "visible", timeout });
       return { ...base, ok: true, timeout_ms: timeout };
     }
-    if (type === "local_storage") {
+    if (type === "local_storage" || type === "session_storage") {
       const value = setupActionValue(action);
-      await page.evaluate(({ key, value }) => {
-        window.localStorage.setItem(key, value);
-      }, { key: action.key, value });
+      await page.evaluate(({ type, key, value }) => {
+        const storage = type === "session_storage" ? window.sessionStorage : window.localStorage;
+        storage.setItem(key, value);
+      }, { type, key: action.key, value });
       if (action.reload === true) {
         await page.reload({ waitUntil: "domcontentloaded", timeout: 45000 });
       }
       return { ...base, ok: true, key: action.key, value_length: value.length, reload: action.reload === true };
     }
+    if (type === "clear_storage") {
+      const storage = action.storage || "both";
+      await page.evaluate(({ storage }) => {
+        if (storage === "local" || storage === "both") window.localStorage.clear();
+        if (storage === "session" || storage === "both") window.sessionStorage.clear();
+      }, { storage });
+      if (action.reload === true) {
+        await page.reload({ waitUntil: "domcontentloaded", timeout: 45000 });
+      }
+      return { ...base, ok: true, storage, reload: action.reload === true };
+    }
     if (type === "click") {
       const locator = page.locator(action.selector);
       const count = await locator.count();
@@ -1296,7 +1320,7 @@ 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 });
+      await locator.nth(targetIndex).click({ timeout, noWaitAfter: true });
       return { ...base, ok: true, count, target_index: targetIndex, text: matchedText };
     }
     if (type === "fill" || type === "set_input_value") {

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_count_at_least", "text_visible", "text_absent", "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", "local_storage", "wait", "wait_for_selector", "wait_for_text"];
+declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "fill", "set_input_value", "local_storage", "session_storage", "clear_storage", "wait", "wait_for_selector", "wait_for_text"];
 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];
@@ -31,6 +31,7 @@ interface RiddleProofProfileSetupAction {
     timeout_ms?: number;
     after_ms?: number;
     reload?: boolean;
+    storage?: "local" | "session" | "both";
     continue_on_failure?: boolean;
 }
 interface RiddleProofProfileNetworkMock {

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_count_at_least", "text_visible", "text_absent", "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", "local_storage", "wait", "wait_for_selector", "wait_for_text"];
+declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "fill", "set_input_value", "local_storage", "session_storage", "clear_storage", "wait", "wait_for_selector", "wait_for_text"];
 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];
@@ -31,6 +31,7 @@ interface RiddleProofProfileSetupAction {
     timeout_ms?: number;
     after_ms?: number;
     reload?: boolean;
+    storage?: "local" | "session" | "both";
     continue_on_failure?: boolean;
 }
 interface RiddleProofProfileNetworkMock {

package/dist/profile.js

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

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

@@ -120,7 +120,7 @@ declare function buildSetupArgs(params: WorkflowParams, config: ReturnType<typeo
     target_image_hash: string;
     viewport_matrix_json: string;
     deterministic_setup_json: string;
-    reference: "prod" | "before" | "both";
+    reference: "before" | "prod" | "both";
     base_branch: string;
     before_ref: string;
     allow_static_preview_fallback: string;

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

@@ -120,7 +120,7 @@ declare function buildSetupArgs(params: WorkflowParams, config: ReturnType<typeo
     target_image_hash: string;
     viewport_matrix_json: string;
     deterministic_setup_json: string;
-    reference: "prod" | "before" | "both";
+    reference: "before" | "prod" | "both";
     base_branch: string;
     before_ref: string;
     allow_static_preview_fallback: string;

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: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "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: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "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: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "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: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "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: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "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: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
     state_path: string;
     stage: any;
     summary: string;

package/package.json

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