@riddledc/riddle-proof 0.7.47 → 0.7.49

package/README.md

@@ -237,16 +237,21 @@ where the second request must carry newer state.
 `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`, `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`.
+`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
+`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`.
+`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-NJDY7HYE.js → chunk-Q3X6UTPP.js}

@@ -32,6 +32,9 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "click",
   "fill",
   "set_input_value",
+  "assert_text_visible",
+  "assert_text_absent",
+  "assert_selector_count",
   "local_storage",
   "session_storage",
   "clear_storage",
@@ -205,12 +208,19 @@ 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 === "fill" || type === "set_input_value" || 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" || type === "assert_text_visible" || type === "assert_text_absent" || type === "assert_selector_count") && !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.`);
   }
+  if ((type === "assert_text_visible" || type === "assert_text_absent") && !stringValue(input.text) && !stringValue(input.pattern)) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires text or pattern.`);
+  }
+  const expectedCount = numberValue(input.expected_count ?? input.expectedCount ?? input.count);
+  if (type === "assert_selector_count" && (expectedCount === void 0 || !Number.isInteger(expectedCount) || expectedCount < 0)) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires non-negative integer expected_count.`);
+  }
   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) {
@@ -233,6 +243,7 @@ function normalizeSetupAction(input, index) {
     pattern: stringValue(input.pattern),
     flags: stringValue(input.flags),
     index: numberValue(input.index),
+    expected_count: expectedCount,
     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),
@@ -318,6 +329,7 @@ function normalizeNetworkMockResponsePayload(input, label, defaults = {}) {
     headers: stringRecord(input.headers) || defaults.headers,
     body,
     body_json: hasJsonBody ? toJsonValue(input.body_json ?? input.bodyJson ?? input.json) : defaults.body_json,
+    delay_ms: normalizeNetworkMockDelay(input, label, defaults.delay_ms),
     capture_request_body: requestBody.capture_request_body,
     request_body_contains: requestBody.request_body_contains,
     request_body_patterns: requestBody.request_body_patterns,
@@ -325,6 +337,16 @@ function normalizeNetworkMockResponsePayload(input, label, defaults = {}) {
     request_body_not_patterns: requestBody.request_body_not_patterns
   };
 }
+function normalizeNetworkMockDelay(input, label, defaultValue) {
+  const value = numberValue(
+    input.delay_ms ?? input.delayMs ?? input.wait_ms ?? input.waitMs ?? input.latency_ms ?? input.latencyMs
+  ) ?? defaultValue;
+  if (value === void 0) return void 0;
+  if (!Number.isInteger(value) || value < 0 || value > 6e4) {
+    throw new Error(`${label}.delay_ms must be an integer from 0 to 60000.`);
+  }
+  return value;
+}
 function normalizeNetworkMockResponses(value, mockIndex, defaults) {
   if (value === void 0) return void 0;
   if (!Array.isArray(value)) throw new Error(`target.network_mocks[${mockIndex}].responses must be an array.`);
@@ -335,7 +357,8 @@ function normalizeNetworkMockResponses(value, mockIndex, defaults) {
     content_type: defaults.content_type,
     headers: defaults.headers,
     body: defaults.body,
-    body_json: defaults.body_json
+    body_json: defaults.body_json,
+    delay_ms: defaults.delay_ms
   };
   return value.map((response, responseIndex) => {
     if (!isRecord(response)) {
@@ -2034,6 +2057,7 @@ async function registerNetworkMocks(mocks) {
         const requestBody = shouldCaptureRequestBody && request.postData ? request.postData() || "" : "";
         const requestBodyFailures = shouldCaptureRequestBody ? networkMockRequestBodyFailures(requestBody, mock, responseBodyContract) : [];
         const status = response.status || mock.status || 200;
+        const delayMs = numberValue(response.delay_ms) || 0;
         const event = {
           ok: true,
           label: mock.label,
@@ -2046,6 +2070,7 @@ async function registerNetworkMocks(mocks) {
           method,
           status,
         };
+        if (delayMs) event.delay_ms = delayMs;
         if (shouldCaptureRequestBody) {
           event.request_body_matches = requestBodyFailures.length === 0;
           event.request_body_failures = requestBodyFailures;
@@ -2053,6 +2078,7 @@ async function registerNetworkMocks(mocks) {
           event.request_body_sample = compactNetworkMockRequestBody(requestBody);
         }
         networkMockEvents.push(event);
+        if (delayMs) await new Promise((resolve) => setTimeout(resolve, delayMs));
         await route.fulfill({
           status,
           headers,
@@ -2150,6 +2176,19 @@ async function executeSetupAction(action, ordinal) {
       await locator.nth(targetIndex).fill(value, { timeout });
       return { ...base, ok: true, count, target_index: targetIndex, value_length: value.length };
     }
+    if (type === "assert_selector_count") {
+      const locator = page.locator(action.selector);
+      const expectedCount = setupNumber(action.expected_count, -1);
+      if (!Number.isInteger(expectedCount) || expectedCount < 0) return { ...base, reason: "invalid_expected_count", expected_count: action.expected_count };
+      const startedAt = Date.now();
+      let count = 0;
+      while (Date.now() - startedAt <= timeout) {
+        count = await locator.count().catch(() => 0);
+        if (count === expectedCount) return { ...base, ok: true, count, expected_count: expectedCount, timeout_ms: timeout };
+        await page.waitForTimeout(100);
+      }
+      return { ...base, reason: "selector_count_mismatch", count, expected_count: expectedCount, timeout_ms: timeout };
+    }
     if (type === "wait_for_text") {
       const locator = page.locator(action.selector);
       const startedAt = Date.now();
@@ -2167,6 +2206,47 @@ async function executeSetupAction(action, ordinal) {
       }
       return { ...base, reason: "text_not_found", text: compactSetupResultText(lastText), timeout_ms: timeout };
     }
+    if (type === "assert_text_visible" || type === "assert_text_absent") {
+      const locator = page.locator(action.selector);
+      const startedAt = Date.now();
+      let lastText = "";
+      let matchedText = "";
+      let hiddenMatch = false;
+      while (Date.now() - startedAt <= timeout) {
+        const count = await locator.count().catch(() => 0);
+        let matched = false;
+        matchedText = "";
+        hiddenMatch = false;
+        for (let index = 0; index < count; index += 1) {
+          const text = await setupLocatorText(locator, index);
+          lastText = text || lastText;
+          if (setupTextMatches(text, action)) {
+            matched = true;
+            matchedText = text;
+            if (type === "assert_text_visible") {
+              const visible = await setupLocatorVisible(locator, index);
+              if (visible) {
+                return { ...base, ok: true, count, text: compactSetupResultText(text), target_index: index, timeout_ms: timeout };
+              }
+              hiddenMatch = true;
+              break;
+            }
+            break;
+          }
+        }
+        if (type === "assert_text_absent" && !matched) {
+          return { ...base, ok: true, count, timeout_ms: timeout };
+        }
+        await page.waitForTimeout(100);
+      }
+      if (type === "assert_text_visible") {
+        if (hiddenMatch) {
+          return { ...base, reason: "matching_element_not_visible", text: compactSetupResultText(matchedText), timeout_ms: timeout };
+        }
+        return { ...base, reason: "text_not_found", text: compactSetupResultText(lastText), timeout_ms: timeout };
+      }
+      return { ...base, reason: "text_still_present", text: compactSetupResultText(matchedText || lastText), timeout_ms: timeout };
+    }
     return { ...base, reason: "unsupported_action" };
   } catch (error) {
     return { ...base, error: String(error && error.message ? error.message : error).slice(0, 1000) };

package/dist/cli.cjs

@@ -6905,6 +6905,9 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "click",
   "fill",
   "set_input_value",
+  "assert_text_visible",
+  "assert_text_absent",
+  "assert_selector_count",
   "local_storage",
   "session_storage",
   "clear_storage",
@@ -7078,12 +7081,19 @@ 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 === "fill" || type === "set_input_value" || 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" || type === "assert_text_visible" || type === "assert_text_absent" || type === "assert_selector_count") && !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.`);
   }
+  if ((type === "assert_text_visible" || type === "assert_text_absent") && !stringValue2(input.text) && !stringValue2(input.pattern)) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires text or pattern.`);
+  }
+  const expectedCount = numberValue(input.expected_count ?? input.expectedCount ?? input.count);
+  if (type === "assert_selector_count" && (expectedCount === void 0 || !Number.isInteger(expectedCount) || expectedCount < 0)) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires non-negative integer expected_count.`);
+  }
   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) {
@@ -7106,6 +7116,7 @@ function normalizeSetupAction(input, index) {
     pattern: stringValue2(input.pattern),
     flags: stringValue2(input.flags),
     index: numberValue(input.index),
+    expected_count: expectedCount,
     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),
@@ -7191,6 +7202,7 @@ function normalizeNetworkMockResponsePayload(input, label, defaults = {}) {
     headers: stringRecord(input.headers) || defaults.headers,
     body,
     body_json: hasJsonBody ? toJsonValue(input.body_json ?? input.bodyJson ?? input.json) : defaults.body_json,
+    delay_ms: normalizeNetworkMockDelay(input, label, defaults.delay_ms),
     capture_request_body: requestBody.capture_request_body,
     request_body_contains: requestBody.request_body_contains,
     request_body_patterns: requestBody.request_body_patterns,
@@ -7198,6 +7210,16 @@ function normalizeNetworkMockResponsePayload(input, label, defaults = {}) {
     request_body_not_patterns: requestBody.request_body_not_patterns
   };
 }
+function normalizeNetworkMockDelay(input, label, defaultValue) {
+  const value = numberValue(
+    input.delay_ms ?? input.delayMs ?? input.wait_ms ?? input.waitMs ?? input.latency_ms ?? input.latencyMs
+  ) ?? defaultValue;
+  if (value === void 0) return void 0;
+  if (!Number.isInteger(value) || value < 0 || value > 6e4) {
+    throw new Error(`${label}.delay_ms must be an integer from 0 to 60000.`);
+  }
+  return value;
+}
 function normalizeNetworkMockResponses(value, mockIndex, defaults) {
   if (value === void 0) return void 0;
   if (!Array.isArray(value)) throw new Error(`target.network_mocks[${mockIndex}].responses must be an array.`);
@@ -7208,7 +7230,8 @@ function normalizeNetworkMockResponses(value, mockIndex, defaults) {
     content_type: defaults.content_type,
     headers: defaults.headers,
     body: defaults.body,
-    body_json: defaults.body_json
+    body_json: defaults.body_json,
+    delay_ms: defaults.delay_ms
   };
   return value.map((response, responseIndex) => {
     if (!isRecord(response)) {
@@ -8891,6 +8914,7 @@ async function registerNetworkMocks(mocks) {
         const requestBody = shouldCaptureRequestBody && request.postData ? request.postData() || "" : "";
         const requestBodyFailures = shouldCaptureRequestBody ? networkMockRequestBodyFailures(requestBody, mock, responseBodyContract) : [];
         const status = response.status || mock.status || 200;
+        const delayMs = numberValue(response.delay_ms) || 0;
         const event = {
           ok: true,
           label: mock.label,
@@ -8903,6 +8927,7 @@ async function registerNetworkMocks(mocks) {
           method,
           status,
         };
+        if (delayMs) event.delay_ms = delayMs;
         if (shouldCaptureRequestBody) {
           event.request_body_matches = requestBodyFailures.length === 0;
           event.request_body_failures = requestBodyFailures;
@@ -8910,6 +8935,7 @@ async function registerNetworkMocks(mocks) {
           event.request_body_sample = compactNetworkMockRequestBody(requestBody);
         }
         networkMockEvents.push(event);
+        if (delayMs) await new Promise((resolve) => setTimeout(resolve, delayMs));
         await route.fulfill({
           status,
           headers,
@@ -9007,6 +9033,19 @@ async function executeSetupAction(action, ordinal) {
       await locator.nth(targetIndex).fill(value, { timeout });
       return { ...base, ok: true, count, target_index: targetIndex, value_length: value.length };
     }
+    if (type === "assert_selector_count") {
+      const locator = page.locator(action.selector);
+      const expectedCount = setupNumber(action.expected_count, -1);
+      if (!Number.isInteger(expectedCount) || expectedCount < 0) return { ...base, reason: "invalid_expected_count", expected_count: action.expected_count };
+      const startedAt = Date.now();
+      let count = 0;
+      while (Date.now() - startedAt <= timeout) {
+        count = await locator.count().catch(() => 0);
+        if (count === expectedCount) return { ...base, ok: true, count, expected_count: expectedCount, timeout_ms: timeout };
+        await page.waitForTimeout(100);
+      }
+      return { ...base, reason: "selector_count_mismatch", count, expected_count: expectedCount, timeout_ms: timeout };
+    }
     if (type === "wait_for_text") {
       const locator = page.locator(action.selector);
       const startedAt = Date.now();
@@ -9024,6 +9063,47 @@ async function executeSetupAction(action, ordinal) {
       }
       return { ...base, reason: "text_not_found", text: compactSetupResultText(lastText), timeout_ms: timeout };
     }
+    if (type === "assert_text_visible" || type === "assert_text_absent") {
+      const locator = page.locator(action.selector);
+      const startedAt = Date.now();
+      let lastText = "";
+      let matchedText = "";
+      let hiddenMatch = false;
+      while (Date.now() - startedAt <= timeout) {
+        const count = await locator.count().catch(() => 0);
+        let matched = false;
+        matchedText = "";
+        hiddenMatch = false;
+        for (let index = 0; index < count; index += 1) {
+          const text = await setupLocatorText(locator, index);
+          lastText = text || lastText;
+          if (setupTextMatches(text, action)) {
+            matched = true;
+            matchedText = text;
+            if (type === "assert_text_visible") {
+              const visible = await setupLocatorVisible(locator, index);
+              if (visible) {
+                return { ...base, ok: true, count, text: compactSetupResultText(text), target_index: index, timeout_ms: timeout };
+              }
+              hiddenMatch = true;
+              break;
+            }
+            break;
+          }
+        }
+        if (type === "assert_text_absent" && !matched) {
+          return { ...base, ok: true, count, timeout_ms: timeout };
+        }
+        await page.waitForTimeout(100);
+      }
+      if (type === "assert_text_visible") {
+        if (hiddenMatch) {
+          return { ...base, reason: "matching_element_not_visible", text: compactSetupResultText(matchedText), timeout_ms: timeout };
+        }
+        return { ...base, reason: "text_not_found", text: compactSetupResultText(lastText), timeout_ms: timeout };
+      }
+      return { ...base, reason: "text_still_present", text: compactSetupResultText(matchedText || lastText), timeout_ms: timeout };
+    }
     return { ...base, reason: "unsupported_action" };
   } catch (error) {
     return { ...base, error: String(error && error.message ? error.message : error).slice(0, 1000) };

package/dist/cli.js

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

package/dist/index.cjs

@@ -8746,6 +8746,9 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "click",
   "fill",
   "set_input_value",
+  "assert_text_visible",
+  "assert_text_absent",
+  "assert_selector_count",
   "local_storage",
   "session_storage",
   "clear_storage",
@@ -8919,12 +8922,19 @@ 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 === "fill" || type === "set_input_value" || 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" || type === "assert_text_visible" || type === "assert_text_absent" || type === "assert_selector_count") && !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.`);
   }
+  if ((type === "assert_text_visible" || type === "assert_text_absent") && !stringValue5(input.text) && !stringValue5(input.pattern)) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires text or pattern.`);
+  }
+  const expectedCount = numberValue3(input.expected_count ?? input.expectedCount ?? input.count);
+  if (type === "assert_selector_count" && (expectedCount === void 0 || !Number.isInteger(expectedCount) || expectedCount < 0)) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires non-negative integer expected_count.`);
+  }
   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) {
@@ -8947,6 +8957,7 @@ function normalizeSetupAction(input, index) {
     pattern: stringValue5(input.pattern),
     flags: stringValue5(input.flags),
     index: numberValue3(input.index),
+    expected_count: expectedCount,
     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),
@@ -9032,6 +9043,7 @@ function normalizeNetworkMockResponsePayload(input, label, defaults = {}) {
     headers: stringRecord(input.headers) || defaults.headers,
     body,
     body_json: hasJsonBody ? toJsonValue(input.body_json ?? input.bodyJson ?? input.json) : defaults.body_json,
+    delay_ms: normalizeNetworkMockDelay(input, label, defaults.delay_ms),
     capture_request_body: requestBody.capture_request_body,
     request_body_contains: requestBody.request_body_contains,
     request_body_patterns: requestBody.request_body_patterns,
@@ -9039,6 +9051,16 @@ function normalizeNetworkMockResponsePayload(input, label, defaults = {}) {
     request_body_not_patterns: requestBody.request_body_not_patterns
   };
 }
+function normalizeNetworkMockDelay(input, label, defaultValue) {
+  const value = numberValue3(
+    input.delay_ms ?? input.delayMs ?? input.wait_ms ?? input.waitMs ?? input.latency_ms ?? input.latencyMs
+  ) ?? defaultValue;
+  if (value === void 0) return void 0;
+  if (!Number.isInteger(value) || value < 0 || value > 6e4) {
+    throw new Error(`${label}.delay_ms must be an integer from 0 to 60000.`);
+  }
+  return value;
+}
 function normalizeNetworkMockResponses(value, mockIndex, defaults) {
   if (value === void 0) return void 0;
   if (!Array.isArray(value)) throw new Error(`target.network_mocks[${mockIndex}].responses must be an array.`);
@@ -9049,7 +9071,8 @@ function normalizeNetworkMockResponses(value, mockIndex, defaults) {
     content_type: defaults.content_type,
     headers: defaults.headers,
     body: defaults.body,
-    body_json: defaults.body_json
+    body_json: defaults.body_json,
+    delay_ms: defaults.delay_ms
   };
   return value.map((response, responseIndex) => {
     if (!isRecord2(response)) {
@@ -10748,6 +10771,7 @@ async function registerNetworkMocks(mocks) {
         const requestBody = shouldCaptureRequestBody && request.postData ? request.postData() || "" : "";
         const requestBodyFailures = shouldCaptureRequestBody ? networkMockRequestBodyFailures(requestBody, mock, responseBodyContract) : [];
         const status = response.status || mock.status || 200;
+        const delayMs = numberValue(response.delay_ms) || 0;
         const event = {
           ok: true,
           label: mock.label,
@@ -10760,6 +10784,7 @@ async function registerNetworkMocks(mocks) {
           method,
           status,
         };
+        if (delayMs) event.delay_ms = delayMs;
         if (shouldCaptureRequestBody) {
           event.request_body_matches = requestBodyFailures.length === 0;
           event.request_body_failures = requestBodyFailures;
@@ -10767,6 +10792,7 @@ async function registerNetworkMocks(mocks) {
           event.request_body_sample = compactNetworkMockRequestBody(requestBody);
         }
         networkMockEvents.push(event);
+        if (delayMs) await new Promise((resolve) => setTimeout(resolve, delayMs));
         await route.fulfill({
           status,
           headers,
@@ -10864,6 +10890,19 @@ async function executeSetupAction(action, ordinal) {
       await locator.nth(targetIndex).fill(value, { timeout });
       return { ...base, ok: true, count, target_index: targetIndex, value_length: value.length };
     }
+    if (type === "assert_selector_count") {
+      const locator = page.locator(action.selector);
+      const expectedCount = setupNumber(action.expected_count, -1);
+      if (!Number.isInteger(expectedCount) || expectedCount < 0) return { ...base, reason: "invalid_expected_count", expected_count: action.expected_count };
+      const startedAt = Date.now();
+      let count = 0;
+      while (Date.now() - startedAt <= timeout) {
+        count = await locator.count().catch(() => 0);
+        if (count === expectedCount) return { ...base, ok: true, count, expected_count: expectedCount, timeout_ms: timeout };
+        await page.waitForTimeout(100);
+      }
+      return { ...base, reason: "selector_count_mismatch", count, expected_count: expectedCount, timeout_ms: timeout };
+    }
     if (type === "wait_for_text") {
       const locator = page.locator(action.selector);
       const startedAt = Date.now();
@@ -10881,6 +10920,47 @@ async function executeSetupAction(action, ordinal) {
       }
       return { ...base, reason: "text_not_found", text: compactSetupResultText(lastText), timeout_ms: timeout };
     }
+    if (type === "assert_text_visible" || type === "assert_text_absent") {
+      const locator = page.locator(action.selector);
+      const startedAt = Date.now();
+      let lastText = "";
+      let matchedText = "";
+      let hiddenMatch = false;
+      while (Date.now() - startedAt <= timeout) {
+        const count = await locator.count().catch(() => 0);
+        let matched = false;
+        matchedText = "";
+        hiddenMatch = false;
+        for (let index = 0; index < count; index += 1) {
+          const text = await setupLocatorText(locator, index);
+          lastText = text || lastText;
+          if (setupTextMatches(text, action)) {
+            matched = true;
+            matchedText = text;
+            if (type === "assert_text_visible") {
+              const visible = await setupLocatorVisible(locator, index);
+              if (visible) {
+                return { ...base, ok: true, count, text: compactSetupResultText(text), target_index: index, timeout_ms: timeout };
+              }
+              hiddenMatch = true;
+              break;
+            }
+            break;
+          }
+        }
+        if (type === "assert_text_absent" && !matched) {
+          return { ...base, ok: true, count, timeout_ms: timeout };
+        }
+        await page.waitForTimeout(100);
+      }
+      if (type === "assert_text_visible") {
+        if (hiddenMatch) {
+          return { ...base, reason: "matching_element_not_visible", text: compactSetupResultText(matchedText), timeout_ms: timeout };
+        }
+        return { ...base, reason: "text_not_found", text: compactSetupResultText(lastText), timeout_ms: timeout };
+      }
+      return { ...base, reason: "text_still_present", text: compactSetupResultText(matchedText || lastText), timeout_ms: timeout };
+    }
     return { ...base, reason: "unsupported_action" };
   } catch (error) {
     return { ...base, error: String(error && error.message ? error.message : error).slice(0, 1000) };

package/dist/index.js

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

package/dist/profile.cjs

@@ -75,6 +75,9 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "click",
   "fill",
   "set_input_value",
+  "assert_text_visible",
+  "assert_text_absent",
+  "assert_selector_count",
   "local_storage",
   "session_storage",
   "clear_storage",
@@ -248,12 +251,19 @@ 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 === "fill" || type === "set_input_value" || 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" || type === "assert_text_visible" || type === "assert_text_absent" || type === "assert_selector_count") && !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.`);
   }
+  if ((type === "assert_text_visible" || type === "assert_text_absent") && !stringValue(input.text) && !stringValue(input.pattern)) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires text or pattern.`);
+  }
+  const expectedCount = numberValue(input.expected_count ?? input.expectedCount ?? input.count);
+  if (type === "assert_selector_count" && (expectedCount === void 0 || !Number.isInteger(expectedCount) || expectedCount < 0)) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires non-negative integer expected_count.`);
+  }
   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) {
@@ -276,6 +286,7 @@ function normalizeSetupAction(input, index) {
     pattern: stringValue(input.pattern),
     flags: stringValue(input.flags),
     index: numberValue(input.index),
+    expected_count: expectedCount,
     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),
@@ -361,6 +372,7 @@ function normalizeNetworkMockResponsePayload(input, label, defaults = {}) {
     headers: stringRecord(input.headers) || defaults.headers,
     body,
     body_json: hasJsonBody ? toJsonValue(input.body_json ?? input.bodyJson ?? input.json) : defaults.body_json,
+    delay_ms: normalizeNetworkMockDelay(input, label, defaults.delay_ms),
     capture_request_body: requestBody.capture_request_body,
     request_body_contains: requestBody.request_body_contains,
     request_body_patterns: requestBody.request_body_patterns,
@@ -368,6 +380,16 @@ function normalizeNetworkMockResponsePayload(input, label, defaults = {}) {
     request_body_not_patterns: requestBody.request_body_not_patterns
   };
 }
+function normalizeNetworkMockDelay(input, label, defaultValue) {
+  const value = numberValue(
+    input.delay_ms ?? input.delayMs ?? input.wait_ms ?? input.waitMs ?? input.latency_ms ?? input.latencyMs
+  ) ?? defaultValue;
+  if (value === void 0) return void 0;
+  if (!Number.isInteger(value) || value < 0 || value > 6e4) {
+    throw new Error(`${label}.delay_ms must be an integer from 0 to 60000.`);
+  }
+  return value;
+}
 function normalizeNetworkMockResponses(value, mockIndex, defaults) {
   if (value === void 0) return void 0;
   if (!Array.isArray(value)) throw new Error(`target.network_mocks[${mockIndex}].responses must be an array.`);
@@ -378,7 +400,8 @@ function normalizeNetworkMockResponses(value, mockIndex, defaults) {
     content_type: defaults.content_type,
     headers: defaults.headers,
     body: defaults.body,
-    body_json: defaults.body_json
+    body_json: defaults.body_json,
+    delay_ms: defaults.delay_ms
   };
   return value.map((response, responseIndex) => {
     if (!isRecord(response)) {
@@ -2077,6 +2100,7 @@ async function registerNetworkMocks(mocks) {
         const requestBody = shouldCaptureRequestBody && request.postData ? request.postData() || "" : "";
         const requestBodyFailures = shouldCaptureRequestBody ? networkMockRequestBodyFailures(requestBody, mock, responseBodyContract) : [];
         const status = response.status || mock.status || 200;
+        const delayMs = numberValue(response.delay_ms) || 0;
         const event = {
           ok: true,
           label: mock.label,
@@ -2089,6 +2113,7 @@ async function registerNetworkMocks(mocks) {
           method,
           status,
         };
+        if (delayMs) event.delay_ms = delayMs;
         if (shouldCaptureRequestBody) {
           event.request_body_matches = requestBodyFailures.length === 0;
           event.request_body_failures = requestBodyFailures;
@@ -2096,6 +2121,7 @@ async function registerNetworkMocks(mocks) {
           event.request_body_sample = compactNetworkMockRequestBody(requestBody);
         }
         networkMockEvents.push(event);
+        if (delayMs) await new Promise((resolve) => setTimeout(resolve, delayMs));
         await route.fulfill({
           status,
           headers,
@@ -2193,6 +2219,19 @@ async function executeSetupAction(action, ordinal) {
       await locator.nth(targetIndex).fill(value, { timeout });
       return { ...base, ok: true, count, target_index: targetIndex, value_length: value.length };
     }
+    if (type === "assert_selector_count") {
+      const locator = page.locator(action.selector);
+      const expectedCount = setupNumber(action.expected_count, -1);
+      if (!Number.isInteger(expectedCount) || expectedCount < 0) return { ...base, reason: "invalid_expected_count", expected_count: action.expected_count };
+      const startedAt = Date.now();
+      let count = 0;
+      while (Date.now() - startedAt <= timeout) {
+        count = await locator.count().catch(() => 0);
+        if (count === expectedCount) return { ...base, ok: true, count, expected_count: expectedCount, timeout_ms: timeout };
+        await page.waitForTimeout(100);
+      }
+      return { ...base, reason: "selector_count_mismatch", count, expected_count: expectedCount, timeout_ms: timeout };
+    }
     if (type === "wait_for_text") {
       const locator = page.locator(action.selector);
       const startedAt = Date.now();
@@ -2210,6 +2249,47 @@ async function executeSetupAction(action, ordinal) {
       }
       return { ...base, reason: "text_not_found", text: compactSetupResultText(lastText), timeout_ms: timeout };
     }
+    if (type === "assert_text_visible" || type === "assert_text_absent") {
+      const locator = page.locator(action.selector);
+      const startedAt = Date.now();
+      let lastText = "";
+      let matchedText = "";
+      let hiddenMatch = false;
+      while (Date.now() - startedAt <= timeout) {
+        const count = await locator.count().catch(() => 0);
+        let matched = false;
+        matchedText = "";
+        hiddenMatch = false;
+        for (let index = 0; index < count; index += 1) {
+          const text = await setupLocatorText(locator, index);
+          lastText = text || lastText;
+          if (setupTextMatches(text, action)) {
+            matched = true;
+            matchedText = text;
+            if (type === "assert_text_visible") {
+              const visible = await setupLocatorVisible(locator, index);
+              if (visible) {
+                return { ...base, ok: true, count, text: compactSetupResultText(text), target_index: index, timeout_ms: timeout };
+              }
+              hiddenMatch = true;
+              break;
+            }
+            break;
+          }
+        }
+        if (type === "assert_text_absent" && !matched) {
+          return { ...base, ok: true, count, timeout_ms: timeout };
+        }
+        await page.waitForTimeout(100);
+      }
+      if (type === "assert_text_visible") {
+        if (hiddenMatch) {
+          return { ...base, reason: "matching_element_not_visible", text: compactSetupResultText(matchedText), timeout_ms: timeout };
+        }
+        return { ...base, reason: "text_not_found", text: compactSetupResultText(lastText), timeout_ms: timeout };
+      }
+      return { ...base, reason: "text_still_present", text: compactSetupResultText(matchedText || lastText), timeout_ms: timeout };
+    }
     return { ...base, reason: "unsupported_action" };
   } catch (error) {
     return { ...base, error: String(error && error.message ? error.message : error).slice(0, 1000) };

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", "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"];
 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];
@@ -27,6 +27,7 @@ interface RiddleProofProfileSetupAction {
     pattern?: string;
     flags?: string;
     index?: number;
+    expected_count?: number;
     ms?: number;
     timeout_ms?: number;
     after_ms?: number;
@@ -41,6 +42,7 @@ interface RiddleProofProfileNetworkMockResponse {
     headers?: Record<string, string>;
     body?: string;
     body_json?: JsonValue;
+    delay_ms?: number;
     capture_request_body?: boolean;
     request_body_contains?: string[];
     request_body_patterns?: 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", "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"];
 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];
@@ -27,6 +27,7 @@ interface RiddleProofProfileSetupAction {
     pattern?: string;
     flags?: string;
     index?: number;
+    expected_count?: number;
     ms?: number;
     timeout_ms?: number;
     after_ms?: number;
@@ -41,6 +42,7 @@ interface RiddleProofProfileNetworkMockResponse {
     headers?: Record<string, string>;
     body?: string;
     body_json?: JsonValue;
+    delay_ms?: number;
     capture_request_body?: boolean;
     request_body_contains?: string[];
     request_body_patterns?: string[];

package/dist/profile.js

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