@riddledc/riddle-proof 0.7.27 → 0.7.29

package/README.md

@@ -109,7 +109,30 @@ or as a stronger proof base before a change loop.
       { "name": "desktop", "width": 1440, "height": 1000 }
     ],
     "auth": "none",
+    "network_mocks": [
+      {
+        "label": "plans-api",
+        "url": "**/api/plans",
+        "method": "GET",
+        "status": 200,
+        "content_type": "application/json",
+        "json": {
+          "plans": [{ "name": "Builder", "price": "$20" }]
+        }
+      }
+    ],
     "setup_actions": [
+      {
+        "type": "local_storage",
+        "key": "demo-auth",
+        "json": { "role": "tester" },
+        "reload": true
+      },
+      {
+        "type": "fill",
+        "selector": "[data-testid='email']",
+        "value": "builder@example.com"
+      },
       { "type": "click", "selector": "[data-testid='show-plans']" },
       { "type": "wait_for_text", "selector": "body", "text": "Start building" }
     ]
@@ -145,14 +168,23 @@ The package includes a generic starter profile at
 profile directory and replace the selector/text checks with app-specific
 invariants.
 
+`target.network_mocks` is optional. The Riddle runner registers these mocks
+before navigation, records each hit, and adds an implicit
+`network_mocks_succeeded` check when mocks are present. A mock supports
+`url`/`glob`/`pattern`, optional `method`, `status`, `content_type`, `headers`,
+string `body`, JSON `json` / `body_json`, and `required: false` for
+best-effort mocks.
+
 `target.setup_actions` is optional. Use it when the meaningful proof surface
-appears only after a picker, tab, login stub, transport control, or other
-bounded interaction. Supported setup actions are `click`, `wait`,
+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.
+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`.
 
 `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-FUWINYNX.js → chunk-NUGGW7NX.js}

@@ -22,6 +22,9 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
 ];
 var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "click",
+  "fill",
+  "set_input_value",
+  "local_storage",
   "wait",
   "wait_for_selector",
   "wait_for_text"
@@ -35,6 +38,18 @@ function isRecord(value) {
 function stringValue(value) {
   return typeof value === "string" && value.trim() ? value.trim() : void 0;
 }
+function hasOwn(value, key) {
+  return Object.prototype.hasOwnProperty.call(value, key);
+}
+function stringFromOwn(input, ...keys) {
+  for (const key of keys) {
+    if (hasOwn(input, key)) {
+      const value = input[key];
+      if (value !== void 0 && value !== null) return String(value);
+    }
+  }
+  return void 0;
+}
 function numberValue(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
@@ -171,15 +186,30 @@ 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);
   const selector = stringValue(input.selector);
-  if ((type === "click" || type === "wait_for_selector" || type === "wait_for_text") && !selector) {
+  if ((type === "click" || type === "fill" || type === "set_input_value" || type === "wait_for_selector" || type === "wait_for_text") && !selector) {
     throw new Error(`target.setup_actions[${index}] ${type} requires selector.`);
   }
   if (type === "wait_for_text" && !stringValue(input.text) && !stringValue(input.pattern)) {
     throw new Error(`target.setup_actions[${index}] wait_for_text requires text or pattern.`);
   }
+  const value = stringFromOwn(input, "value", "input_value", "inputValue");
+  const hasJsonValue = hasOwn(input, "value_json") || hasOwn(input, "valueJson") || hasOwn(input, "json");
+  if ((type === "fill" || type === "set_input_value") && value === void 0 && !hasJsonValue) {
+    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" && value === void 0 && !hasJsonValue) {
+    throw new Error(`target.setup_actions[${index}] local_storage requires value.`);
+  }
   return {
     type,
     selector,
+    key,
+    value,
+    value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
     text: stringValue(input.text),
     pattern: stringValue(input.pattern),
     flags: stringValue(input.flags),
@@ -187,6 +217,7 @@ function normalizeSetupAction(input, index) {
     ms: numberValue(input.ms) ?? numberValue(input.wait_ms) ?? numberValue(input.waitMs),
     timeout_ms: numberValue(input.timeout_ms) ?? numberValue(input.timeoutMs),
     after_ms: numberValue(input.after_ms) ?? numberValue(input.afterMs),
+    reload: input.reload === true,
     continue_on_failure: input.continue_on_failure === true || input.continueOnFailure === true
   };
 }
@@ -1107,6 +1138,14 @@ function setupTextMatches(sample, action) {
   }
   return String(sample || "").includes(action.text || "");
 }
+function setupHasOwn(action, key) {
+  return Boolean(action) && Object.keys(action).includes(key);
+}
+function setupActionValue(action) {
+  if (setupHasOwn(action, "value_json")) return JSON.stringify(action.value_json);
+  if (setupHasOwn(action, "value")) return String(action.value ?? "");
+  return "";
+}
 async function setupLocatorText(locator, index) {
   return await locator.nth(index).textContent({ timeout: 1000 }).catch(() => "");
 }
@@ -1175,6 +1214,16 @@ async function executeSetupAction(action, ordinal) {
       await page.waitForSelector(action.selector, { state: "visible", timeout });
       return { ...base, ok: true, timeout_ms: timeout };
     }
+    if (type === "local_storage") {
+      const value = setupActionValue(action);
+      await page.evaluate(({ key, value }) => {
+        window.localStorage.setItem(key, value);
+      }, { 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 === "click") {
       const locator = page.locator(action.selector);
       const count = await locator.count();
@@ -1207,6 +1256,16 @@ async function executeSetupAction(action, ordinal) {
       await locator.nth(targetIndex).click({ timeout });
       return { ...base, ok: true, count, target_index: targetIndex, text: matchedText };
     }
+    if (type === "fill" || type === "set_input_value") {
+      const locator = page.locator(action.selector);
+      const count = await locator.count();
+      if (!count) return { ...base, reason: "selector_not_found", count };
+      const targetIndex = Number.isInteger(action.index) ? action.index : 0;
+      if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex };
+      const value = setupActionValue(action);
+      await locator.nth(targetIndex).fill(value, { timeout });
+      return { ...base, ok: true, count, target_index: targetIndex, value_length: value.length };
+    }
     if (type === "wait_for_text") {
       const locator = page.locator(action.selector);
       const startedAt = Date.now();

package/dist/cli.cjs

@@ -6895,6 +6895,9 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
 ];
 var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "click",
+  "fill",
+  "set_input_value",
+  "local_storage",
   "wait",
   "wait_for_selector",
   "wait_for_text"
@@ -6908,6 +6911,18 @@ function isRecord(value) {
 function stringValue2(value) {
   return typeof value === "string" && value.trim() ? value.trim() : void 0;
 }
+function hasOwn(value, key) {
+  return Object.prototype.hasOwnProperty.call(value, key);
+}
+function stringFromOwn(input, ...keys) {
+  for (const key of keys) {
+    if (hasOwn(input, key)) {
+      const value = input[key];
+      if (value !== void 0 && value !== null) return String(value);
+    }
+  }
+  return void 0;
+}
 function numberValue(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
@@ -7044,15 +7059,30 @@ 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);
   const selector = stringValue2(input.selector);
-  if ((type === "click" || type === "wait_for_selector" || type === "wait_for_text") && !selector) {
+  if ((type === "click" || type === "fill" || type === "set_input_value" || type === "wait_for_selector" || type === "wait_for_text") && !selector) {
     throw new Error(`target.setup_actions[${index}] ${type} requires selector.`);
   }
   if (type === "wait_for_text" && !stringValue2(input.text) && !stringValue2(input.pattern)) {
     throw new Error(`target.setup_actions[${index}] wait_for_text requires text or pattern.`);
   }
+  const value = stringFromOwn(input, "value", "input_value", "inputValue");
+  const hasJsonValue = hasOwn(input, "value_json") || hasOwn(input, "valueJson") || hasOwn(input, "json");
+  if ((type === "fill" || type === "set_input_value") && value === void 0 && !hasJsonValue) {
+    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" && value === void 0 && !hasJsonValue) {
+    throw new Error(`target.setup_actions[${index}] local_storage requires value.`);
+  }
   return {
     type,
     selector,
+    key,
+    value,
+    value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
     text: stringValue2(input.text),
     pattern: stringValue2(input.pattern),
     flags: stringValue2(input.flags),
@@ -7060,6 +7090,7 @@ function normalizeSetupAction(input, index) {
     ms: numberValue(input.ms) ?? numberValue(input.wait_ms) ?? numberValue(input.waitMs),
     timeout_ms: numberValue(input.timeout_ms) ?? numberValue(input.timeoutMs),
     after_ms: numberValue(input.after_ms) ?? numberValue(input.afterMs),
+    reload: input.reload === true,
     continue_on_failure: input.continue_on_failure === true || input.continueOnFailure === true
   };
 }
@@ -7964,6 +7995,14 @@ function setupTextMatches(sample, action) {
   }
   return String(sample || "").includes(action.text || "");
 }
+function setupHasOwn(action, key) {
+  return Boolean(action) && Object.keys(action).includes(key);
+}
+function setupActionValue(action) {
+  if (setupHasOwn(action, "value_json")) return JSON.stringify(action.value_json);
+  if (setupHasOwn(action, "value")) return String(action.value ?? "");
+  return "";
+}
 async function setupLocatorText(locator, index) {
   return await locator.nth(index).textContent({ timeout: 1000 }).catch(() => "");
 }
@@ -8032,6 +8071,16 @@ async function executeSetupAction(action, ordinal) {
       await page.waitForSelector(action.selector, { state: "visible", timeout });
       return { ...base, ok: true, timeout_ms: timeout };
     }
+    if (type === "local_storage") {
+      const value = setupActionValue(action);
+      await page.evaluate(({ key, value }) => {
+        window.localStorage.setItem(key, value);
+      }, { 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 === "click") {
       const locator = page.locator(action.selector);
       const count = await locator.count();
@@ -8064,6 +8113,16 @@ async function executeSetupAction(action, ordinal) {
       await locator.nth(targetIndex).click({ timeout });
       return { ...base, ok: true, count, target_index: targetIndex, text: matchedText };
     }
+    if (type === "fill" || type === "set_input_value") {
+      const locator = page.locator(action.selector);
+      const count = await locator.count();
+      if (!count) return { ...base, reason: "selector_not_found", count };
+      const targetIndex = Number.isInteger(action.index) ? action.index : 0;
+      if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex };
+      const value = setupActionValue(action);
+      await locator.nth(targetIndex).fill(value, { timeout });
+      return { ...base, ok: true, count, target_index: targetIndex, value_length: value.length };
+    }
     if (type === "wait_for_text") {
       const locator = page.locator(action.selector);
       const startedAt = Date.now();

package/dist/cli.js

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

package/dist/index.cjs

@@ -8736,6 +8736,9 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
 ];
 var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "click",
+  "fill",
+  "set_input_value",
+  "local_storage",
   "wait",
   "wait_for_selector",
   "wait_for_text"
@@ -8749,6 +8752,18 @@ function isRecord2(value) {
 function stringValue5(value) {
   return typeof value === "string" && value.trim() ? value.trim() : void 0;
 }
+function hasOwn(value, key) {
+  return Object.prototype.hasOwnProperty.call(value, key);
+}
+function stringFromOwn(input, ...keys) {
+  for (const key of keys) {
+    if (hasOwn(input, key)) {
+      const value = input[key];
+      if (value !== void 0 && value !== null) return String(value);
+    }
+  }
+  return void 0;
+}
 function numberValue3(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
@@ -8885,15 +8900,30 @@ 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);
   const selector = stringValue5(input.selector);
-  if ((type === "click" || type === "wait_for_selector" || type === "wait_for_text") && !selector) {
+  if ((type === "click" || type === "fill" || type === "set_input_value" || type === "wait_for_selector" || type === "wait_for_text") && !selector) {
     throw new Error(`target.setup_actions[${index}] ${type} requires selector.`);
   }
   if (type === "wait_for_text" && !stringValue5(input.text) && !stringValue5(input.pattern)) {
     throw new Error(`target.setup_actions[${index}] wait_for_text requires text or pattern.`);
   }
+  const value = stringFromOwn(input, "value", "input_value", "inputValue");
+  const hasJsonValue = hasOwn(input, "value_json") || hasOwn(input, "valueJson") || hasOwn(input, "json");
+  if ((type === "fill" || type === "set_input_value") && value === void 0 && !hasJsonValue) {
+    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" && value === void 0 && !hasJsonValue) {
+    throw new Error(`target.setup_actions[${index}] local_storage requires value.`);
+  }
   return {
     type,
     selector,
+    key,
+    value,
+    value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
     text: stringValue5(input.text),
     pattern: stringValue5(input.pattern),
     flags: stringValue5(input.flags),
@@ -8901,6 +8931,7 @@ function normalizeSetupAction(input, index) {
     ms: numberValue3(input.ms) ?? numberValue3(input.wait_ms) ?? numberValue3(input.waitMs),
     timeout_ms: numberValue3(input.timeout_ms) ?? numberValue3(input.timeoutMs),
     after_ms: numberValue3(input.after_ms) ?? numberValue3(input.afterMs),
+    reload: input.reload === true,
     continue_on_failure: input.continue_on_failure === true || input.continueOnFailure === true
   };
 }
@@ -9821,6 +9852,14 @@ function setupTextMatches(sample, action) {
   }
   return String(sample || "").includes(action.text || "");
 }
+function setupHasOwn(action, key) {
+  return Boolean(action) && Object.keys(action).includes(key);
+}
+function setupActionValue(action) {
+  if (setupHasOwn(action, "value_json")) return JSON.stringify(action.value_json);
+  if (setupHasOwn(action, "value")) return String(action.value ?? "");
+  return "";
+}
 async function setupLocatorText(locator, index) {
   return await locator.nth(index).textContent({ timeout: 1000 }).catch(() => "");
 }
@@ -9889,6 +9928,16 @@ async function executeSetupAction(action, ordinal) {
       await page.waitForSelector(action.selector, { state: "visible", timeout });
       return { ...base, ok: true, timeout_ms: timeout };
     }
+    if (type === "local_storage") {
+      const value = setupActionValue(action);
+      await page.evaluate(({ key, value }) => {
+        window.localStorage.setItem(key, value);
+      }, { 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 === "click") {
       const locator = page.locator(action.selector);
       const count = await locator.count();
@@ -9921,6 +9970,16 @@ async function executeSetupAction(action, ordinal) {
       await locator.nth(targetIndex).click({ timeout });
       return { ...base, ok: true, count, target_index: targetIndex, text: matchedText };
     }
+    if (type === "fill" || type === "set_input_value") {
+      const locator = page.locator(action.selector);
+      const count = await locator.count();
+      if (!count) return { ...base, reason: "selector_not_found", count };
+      const targetIndex = Number.isInteger(action.index) ? action.index : 0;
+      if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex };
+      const value = setupActionValue(action);
+      await locator.nth(targetIndex).fill(value, { timeout });
+      return { ...base, ok: true, count, target_index: targetIndex, value_length: value.length };
+    }
     if (type === "wait_for_text") {
       const locator = page.locator(action.selector);
       const startedAt = Date.now();

package/dist/index.js

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

package/dist/profile.cjs

@@ -65,6 +65,9 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
 ];
 var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "click",
+  "fill",
+  "set_input_value",
+  "local_storage",
   "wait",
   "wait_for_selector",
   "wait_for_text"
@@ -78,6 +81,18 @@ function isRecord(value) {
 function stringValue(value) {
   return typeof value === "string" && value.trim() ? value.trim() : void 0;
 }
+function hasOwn(value, key) {
+  return Object.prototype.hasOwnProperty.call(value, key);
+}
+function stringFromOwn(input, ...keys) {
+  for (const key of keys) {
+    if (hasOwn(input, key)) {
+      const value = input[key];
+      if (value !== void 0 && value !== null) return String(value);
+    }
+  }
+  return void 0;
+}
 function numberValue(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
@@ -214,15 +229,30 @@ 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);
   const selector = stringValue(input.selector);
-  if ((type === "click" || type === "wait_for_selector" || type === "wait_for_text") && !selector) {
+  if ((type === "click" || type === "fill" || type === "set_input_value" || type === "wait_for_selector" || type === "wait_for_text") && !selector) {
     throw new Error(`target.setup_actions[${index}] ${type} requires selector.`);
   }
   if (type === "wait_for_text" && !stringValue(input.text) && !stringValue(input.pattern)) {
     throw new Error(`target.setup_actions[${index}] wait_for_text requires text or pattern.`);
   }
+  const value = stringFromOwn(input, "value", "input_value", "inputValue");
+  const hasJsonValue = hasOwn(input, "value_json") || hasOwn(input, "valueJson") || hasOwn(input, "json");
+  if ((type === "fill" || type === "set_input_value") && value === void 0 && !hasJsonValue) {
+    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" && value === void 0 && !hasJsonValue) {
+    throw new Error(`target.setup_actions[${index}] local_storage requires value.`);
+  }
   return {
     type,
     selector,
+    key,
+    value,
+    value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
     text: stringValue(input.text),
     pattern: stringValue(input.pattern),
     flags: stringValue(input.flags),
@@ -230,6 +260,7 @@ function normalizeSetupAction(input, index) {
     ms: numberValue(input.ms) ?? numberValue(input.wait_ms) ?? numberValue(input.waitMs),
     timeout_ms: numberValue(input.timeout_ms) ?? numberValue(input.timeoutMs),
     after_ms: numberValue(input.after_ms) ?? numberValue(input.afterMs),
+    reload: input.reload === true,
     continue_on_failure: input.continue_on_failure === true || input.continueOnFailure === true
   };
 }
@@ -1150,6 +1181,14 @@ function setupTextMatches(sample, action) {
   }
   return String(sample || "").includes(action.text || "");
 }
+function setupHasOwn(action, key) {
+  return Boolean(action) && Object.keys(action).includes(key);
+}
+function setupActionValue(action) {
+  if (setupHasOwn(action, "value_json")) return JSON.stringify(action.value_json);
+  if (setupHasOwn(action, "value")) return String(action.value ?? "");
+  return "";
+}
 async function setupLocatorText(locator, index) {
   return await locator.nth(index).textContent({ timeout: 1000 }).catch(() => "");
 }
@@ -1218,6 +1257,16 @@ async function executeSetupAction(action, ordinal) {
       await page.waitForSelector(action.selector, { state: "visible", timeout });
       return { ...base, ok: true, timeout_ms: timeout };
     }
+    if (type === "local_storage") {
+      const value = setupActionValue(action);
+      await page.evaluate(({ key, value }) => {
+        window.localStorage.setItem(key, value);
+      }, { 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 === "click") {
       const locator = page.locator(action.selector);
       const count = await locator.count();
@@ -1250,6 +1299,16 @@ async function executeSetupAction(action, ordinal) {
       await locator.nth(targetIndex).click({ timeout });
       return { ...base, ok: true, count, target_index: targetIndex, text: matchedText };
     }
+    if (type === "fill" || type === "set_input_value") {
+      const locator = page.locator(action.selector);
+      const count = await locator.count();
+      if (!count) return { ...base, reason: "selector_not_found", count };
+      const targetIndex = Number.isInteger(action.index) ? action.index : 0;
+      if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex };
+      const value = setupActionValue(action);
+      await locator.nth(targetIndex).fill(value, { timeout });
+      return { ...base, ok: true, count, target_index: targetIndex, value_length: value.length };
+    }
     if (type === "wait_for_text") {
       const locator = page.locator(action.selector);
       const startedAt = Date.now();

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", "wait", "wait_for_selector", "wait_for_text"];
+declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "fill", "set_input_value", "local_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];
@@ -20,6 +20,9 @@ interface RiddleProofProfileViewport {
 interface RiddleProofProfileSetupAction {
     type: RiddleProofProfileSetupActionType;
     selector?: string;
+    key?: string;
+    value?: string;
+    value_json?: JsonValue;
     text?: string;
     pattern?: string;
     flags?: string;
@@ -27,6 +30,7 @@ interface RiddleProofProfileSetupAction {
     ms?: number;
     timeout_ms?: number;
     after_ms?: number;
+    reload?: boolean;
     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", "wait", "wait_for_selector", "wait_for_text"];
+declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "fill", "set_input_value", "local_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];
@@ -20,6 +20,9 @@ interface RiddleProofProfileViewport {
 interface RiddleProofProfileSetupAction {
     type: RiddleProofProfileSetupActionType;
     selector?: string;
+    key?: string;
+    value?: string;
+    value_json?: JsonValue;
     text?: string;
     pattern?: string;
     flags?: string;
@@ -27,6 +30,7 @@ interface RiddleProofProfileSetupAction {
     ms?: number;
     timeout_ms?: number;
     after_ms?: number;
+    reload?: boolean;
     continue_on_failure?: boolean;
 }
 interface RiddleProofProfileNetworkMock {

package/dist/profile.js

@@ -19,7 +19,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-FUWINYNX.js";
+} from "./chunk-NUGGW7NX.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: "before" | "prod" | "both";
+    reference: "prod" | "before" | "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: "before" | "prod" | "both";
+    reference: "prod" | "before" | "both";
     base_branch: string;
     before_ref: string;
     allow_static_preview_fallback: string;

package/package.json

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