@riddledc/riddle-proof 0.7.39 → 0.7.40

package/README.md

@@ -182,7 +182,35 @@ 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.
+best-effort mocks. Use `responses` for retry or recovery profiles where the
+same endpoint should return a sequence, such as first `503` and then `200`.
+Each response accepts the same payload fields plus an optional label:
+
+```json
+{
+  "label": "builder-build",
+  "url": "**/api/build",
+  "method": "POST",
+  "responses": [
+    {
+      "label": "first-build-fails",
+      "status": 503,
+      "json": { "error": "Synthetic build outage" }
+    },
+    {
+      "label": "second-build-succeeds",
+      "status": 200,
+      "json": { "previewUrl": "https://cdn.example/game/index.html" }
+    }
+  ]
+}
+```
+
+When `responses` is present, `network_mocks_succeeded` requires each configured
+response to be hit at least once by default and records `hit_index`,
+`response_index`, and `response_label` for each request. Set
+`required_hit_count` / `min_hits` or `required: false` when a different
+contract is intentional.
 
 `target.setup_actions` is optional. Use it when the meaningful proof surface
 appears only after a picker, tab, login stub, storage seed, form fill,

package/dist/{chunk-L4FLSU7L.js → chunk-RAVOICNN.js}

@@ -246,24 +246,57 @@ function normalizeNetworkMock(input, index) {
   if (!isRecord(input)) throw new Error(`target.network_mocks[${index}] must be an object.`);
   const url = stringValue(input.url) || stringValue(input.glob) || stringValue(input.pattern);
   if (!url) throw new Error(`target.network_mocks[${index}] requires url.`);
-  const status = numberValue(input.status) ?? 200;
-  if (!Number.isInteger(status) || status < 100 || status > 599) {
-    throw new Error(`target.network_mocks[${index}].status must be an HTTP status code.`);
+  const payload = normalizeNetworkMockResponsePayload(input, `target.network_mocks[${index}]`);
+  const responsesInput = input.responses ?? input.sequence;
+  const responses = normalizeNetworkMockResponses(responsesInput, index, payload);
+  const requiredHitCount = numberValue(
+    input.required_hit_count ?? input.requiredHitCount ?? input.required_hits ?? input.requiredHits ?? input.min_hits ?? input.minHits
+  );
+  if (requiredHitCount !== void 0 && (!Number.isInteger(requiredHitCount) || requiredHitCount < 1)) {
+    throw new Error(`target.network_mocks[${index}].required_hit_count must be a positive integer.`);
   }
-  const body = stringValue(input.body) ?? stringValue(input.body_text) ?? stringValue(input.bodyText);
-  const hasJsonBody = Object.prototype.hasOwnProperty.call(input, "body_json") || Object.prototype.hasOwnProperty.call(input, "bodyJson") || Object.prototype.hasOwnProperty.call(input, "json");
   return {
+    ...payload,
     label: normalizeName(input.label || input.name, `network-mock-${index + 1}`),
     url,
     method: stringValue(input.method)?.toUpperCase(),
+    responses,
+    required_hit_count: requiredHitCount,
+    required: input.required === false ? false : true
+  };
+}
+function normalizeNetworkMockResponsePayload(input, label, defaults = {}) {
+  const status = numberValue(input.status) ?? defaults.status ?? 200;
+  if (!Number.isInteger(status) || status < 100 || status > 599) {
+    throw new Error(`${label}.status must be an HTTP status code.`);
+  }
+  const body = stringValue(input.body) ?? stringValue(input.body_text) ?? stringValue(input.bodyText) ?? defaults.body;
+  const hasJsonBody = Object.prototype.hasOwnProperty.call(input, "body_json") || Object.prototype.hasOwnProperty.call(input, "bodyJson") || Object.prototype.hasOwnProperty.call(input, "json");
+  return {
+    label: stringValue(input.label) || stringValue(input.name) || defaults.label,
     status,
-    content_type: stringValue(input.content_type) || stringValue(input.contentType),
-    headers: stringRecord(input.headers),
+    content_type: stringValue(input.content_type) || stringValue(input.contentType) || defaults.content_type,
+    headers: stringRecord(input.headers) || defaults.headers,
     body,
-    body_json: hasJsonBody ? toJsonValue(input.body_json ?? input.bodyJson ?? input.json) : void 0,
-    required: input.required === false ? false : true
+    body_json: hasJsonBody ? toJsonValue(input.body_json ?? input.bodyJson ?? input.json) : defaults.body_json
   };
 }
+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.`);
+  if (!value.length) throw new Error(`target.network_mocks[${mockIndex}].responses must not be empty.`);
+  const responseDefaults = { ...defaults, label: void 0 };
+  return value.map((response, responseIndex) => {
+    if (!isRecord(response)) {
+      throw new Error(`target.network_mocks[${mockIndex}].responses[${responseIndex}] must be an object.`);
+    }
+    return normalizeNetworkMockResponsePayload(
+      response,
+      `target.network_mocks[${mockIndex}].responses[${responseIndex}]`,
+      responseDefaults
+    );
+  });
+}
 function normalizeNetworkMocks(value) {
   if (value === void 0) return void 0;
   if (!Array.isArray(value)) throw new Error("target.network_mocks must be an array.");
@@ -909,12 +942,15 @@ function assessNetworkMocksFromEvidence(profile, evidence) {
   const requiredMocks = mocks.filter((mock) => mock.required !== false);
   for (const mock of requiredMocks) {
     const hits = events.filter((event) => event.label === mock.label && event.ok !== false).length;
-    if (hits < 1) {
+    const requiredHitCount = requiredNetworkMockHitCount(mock);
+    if (hits < requiredHitCount) {
       failed.push({
         label: mock.label,
         url: mock.url,
         method: mock.method || null,
-        reason: "required_mock_not_hit"
+        reason: hits < 1 ? "required_mock_not_hit" : "required_mock_hit_count_not_met",
+        required_hit_count: requiredHitCount,
+        hit_count: hits
       });
     }
   }
@@ -940,11 +976,21 @@ function assessNetworkMocksFromEvidence(profile, evidence) {
         mock.label,
         events.filter((event) => event.label === mock.label && event.ok !== false).length
       ])),
+      required_hits_by_label: Object.fromEntries(requiredMocks.map((mock) => [
+        mock.label,
+        requiredNetworkMockHitCount(mock)
+      ])),
       failed
     },
     message: failed.length ? `Network mocks failed or were not hit for ${failed.length} mock(s).` : void 0
   };
 }
+function requiredNetworkMockHitCount(mock) {
+  if (mock.required === false) return 0;
+  if (mock.required_hit_count !== void 0) return mock.required_hit_count;
+  if (Array.isArray(mock.responses) && mock.responses.length) return mock.responses.length;
+  return 1;
+}
 function profileStatusFromEvidence(profile, evidence, checks) {
   if (!evidence) return "proof_insufficient";
   const viewports = evidence.viewports || [];
@@ -1239,6 +1285,12 @@ function horizontalBoundsOverflowPx(value) {
   }
   return roundPixels(max);
 }
+function requiredNetworkMockHitCount(mock) {
+  if (!mock || mock.required === false) return 0;
+  if (Number.isInteger(mock.required_hit_count) && mock.required_hit_count > 0) return mock.required_hit_count;
+  if (Array.isArray(mock.responses) && mock.responses.length) return mock.responses.length;
+  return 1;
+}
 function assessProfile(profile, evidence) {
   const checks = [];
   const viewports = evidence.viewports || [];
@@ -1248,12 +1300,15 @@ function assessProfile(profile, evidence) {
     const failed = [];
     for (const mock of requiredMocks) {
       const hits = events.filter((event) => event && event.label === mock.label && event.ok !== false).length;
-      if (hits < 1) {
+      const requiredHitCount = requiredNetworkMockHitCount(mock);
+      if (hits < requiredHitCount) {
         failed.push({
           label: mock.label,
           url: mock.url,
           method: mock.method || null,
-          reason: "required_mock_not_hit",
+          reason: hits < 1 ? "required_mock_not_hit" : "required_mock_hit_count_not_met",
+          required_hit_count: requiredHitCount,
+          hit_count: hits,
         });
       }
     }
@@ -1268,8 +1323,10 @@ function assessProfile(profile, evidence) {
       }
     }
     const hitsByLabel = {};
+    const requiredHitsByLabel = {};
     for (const mock of profile.target.network_mocks) {
       hitsByLabel[mock.label] = events.filter((event) => event && event.label === mock.label && event.ok !== false).length;
+      if (mock && mock.required !== false) requiredHitsByLabel[mock.label] = requiredNetworkMockHitCount(mock);
     }
     checks.push({
       type: "network_mocks_succeeded",
@@ -1280,6 +1337,7 @@ function assessProfile(profile, evidence) {
         required_count: requiredMocks.length,
         hit_count: events.filter((event) => event && event.ok !== false).length,
         hits_by_label: hitsByLabel,
+        required_hits_by_label: requiredHitsByLabel,
         failed,
       },
       message: failed.length ? "Network mocks failed or were not hit for " + failed.length + " mock(s)." : undefined,
@@ -1678,6 +1736,7 @@ async function setupLocatorVisible(locator, index) {
 }
 async function registerNetworkMocks(mocks) {
   for (const mock of mocks || []) {
+    let hitCount = 0;
     await page.route(mock.url, async (route) => {
       const request = route.request();
       const method = request.method ? request.method() : "";
@@ -1686,22 +1745,31 @@ async function registerNetworkMocks(mocks) {
         return;
       }
       try {
-        const headers = { ...(mock.headers || {}) };
-        let body = mock.body || "";
-        let contentType = mock.content_type || headers["content-type"] || headers["Content-Type"] || "text/plain";
-        if (mock.body_json !== undefined) {
-          body = JSON.stringify(mock.body_json);
-          contentType = mock.content_type || headers["content-type"] || headers["Content-Type"] || "application/json";
+        const responses = Array.isArray(mock.responses) ? mock.responses : [];
+        const hitIndex = hitCount;
+        hitCount += 1;
+        const responseIndex = responses.length ? Math.min(hitIndex, responses.length - 1) : null;
+        const response = responseIndex === null ? mock : responses[responseIndex];
+        const headers = { ...(response.headers || mock.headers || {}) };
+        let body = response.body || "";
+        let contentType = response.content_type || headers["content-type"] || headers["Content-Type"] || "text/plain";
+        if (response.body_json !== undefined) {
+          body = JSON.stringify(response.body_json);
+          contentType = response.content_type || headers["content-type"] || headers["Content-Type"] || "application/json";
         }
         networkMockEvents.push({
           ok: true,
           label: mock.label,
+          response_label: response.label || null,
+          hit_index: hitIndex,
+          response_index: responseIndex,
+          sequence_reused: responseIndex !== null && hitIndex >= responses.length,
           url: request.url(),
           method,
-          status: mock.status || 200,
+          status: response.status || mock.status || 200,
         });
         await route.fulfill({
-          status: mock.status || 200,
+          status: response.status || mock.status || 200,
           headers,
           contentType,
           body,

package/dist/cli.cjs

@@ -7119,24 +7119,57 @@ function normalizeNetworkMock(input, index) {
   if (!isRecord(input)) throw new Error(`target.network_mocks[${index}] must be an object.`);
   const url = stringValue2(input.url) || stringValue2(input.glob) || stringValue2(input.pattern);
   if (!url) throw new Error(`target.network_mocks[${index}] requires url.`);
-  const status = numberValue(input.status) ?? 200;
-  if (!Number.isInteger(status) || status < 100 || status > 599) {
-    throw new Error(`target.network_mocks[${index}].status must be an HTTP status code.`);
+  const payload = normalizeNetworkMockResponsePayload(input, `target.network_mocks[${index}]`);
+  const responsesInput = input.responses ?? input.sequence;
+  const responses = normalizeNetworkMockResponses(responsesInput, index, payload);
+  const requiredHitCount = numberValue(
+    input.required_hit_count ?? input.requiredHitCount ?? input.required_hits ?? input.requiredHits ?? input.min_hits ?? input.minHits
+  );
+  if (requiredHitCount !== void 0 && (!Number.isInteger(requiredHitCount) || requiredHitCount < 1)) {
+    throw new Error(`target.network_mocks[${index}].required_hit_count must be a positive integer.`);
   }
-  const body = stringValue2(input.body) ?? stringValue2(input.body_text) ?? stringValue2(input.bodyText);
-  const hasJsonBody = Object.prototype.hasOwnProperty.call(input, "body_json") || Object.prototype.hasOwnProperty.call(input, "bodyJson") || Object.prototype.hasOwnProperty.call(input, "json");
   return {
+    ...payload,
     label: normalizeName(input.label || input.name, `network-mock-${index + 1}`),
     url,
     method: stringValue2(input.method)?.toUpperCase(),
+    responses,
+    required_hit_count: requiredHitCount,
+    required: input.required === false ? false : true
+  };
+}
+function normalizeNetworkMockResponsePayload(input, label, defaults = {}) {
+  const status = numberValue(input.status) ?? defaults.status ?? 200;
+  if (!Number.isInteger(status) || status < 100 || status > 599) {
+    throw new Error(`${label}.status must be an HTTP status code.`);
+  }
+  const body = stringValue2(input.body) ?? stringValue2(input.body_text) ?? stringValue2(input.bodyText) ?? defaults.body;
+  const hasJsonBody = Object.prototype.hasOwnProperty.call(input, "body_json") || Object.prototype.hasOwnProperty.call(input, "bodyJson") || Object.prototype.hasOwnProperty.call(input, "json");
+  return {
+    label: stringValue2(input.label) || stringValue2(input.name) || defaults.label,
     status,
-    content_type: stringValue2(input.content_type) || stringValue2(input.contentType),
-    headers: stringRecord(input.headers),
+    content_type: stringValue2(input.content_type) || stringValue2(input.contentType) || defaults.content_type,
+    headers: stringRecord(input.headers) || defaults.headers,
     body,
-    body_json: hasJsonBody ? toJsonValue(input.body_json ?? input.bodyJson ?? input.json) : void 0,
-    required: input.required === false ? false : true
+    body_json: hasJsonBody ? toJsonValue(input.body_json ?? input.bodyJson ?? input.json) : defaults.body_json
   };
 }
+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.`);
+  if (!value.length) throw new Error(`target.network_mocks[${mockIndex}].responses must not be empty.`);
+  const responseDefaults = { ...defaults, label: void 0 };
+  return value.map((response, responseIndex) => {
+    if (!isRecord(response)) {
+      throw new Error(`target.network_mocks[${mockIndex}].responses[${responseIndex}] must be an object.`);
+    }
+    return normalizeNetworkMockResponsePayload(
+      response,
+      `target.network_mocks[${mockIndex}].responses[${responseIndex}]`,
+      responseDefaults
+    );
+  });
+}
 function normalizeNetworkMocks(value) {
   if (value === void 0) return void 0;
   if (!Array.isArray(value)) throw new Error("target.network_mocks must be an array.");
@@ -7782,12 +7815,15 @@ function assessNetworkMocksFromEvidence(profile, evidence) {
   const requiredMocks = mocks.filter((mock) => mock.required !== false);
   for (const mock of requiredMocks) {
     const hits = events.filter((event) => event.label === mock.label && event.ok !== false).length;
-    if (hits < 1) {
+    const requiredHitCount = requiredNetworkMockHitCount(mock);
+    if (hits < requiredHitCount) {
       failed.push({
         label: mock.label,
         url: mock.url,
         method: mock.method || null,
-        reason: "required_mock_not_hit"
+        reason: hits < 1 ? "required_mock_not_hit" : "required_mock_hit_count_not_met",
+        required_hit_count: requiredHitCount,
+        hit_count: hits
       });
     }
   }
@@ -7813,11 +7849,21 @@ function assessNetworkMocksFromEvidence(profile, evidence) {
         mock.label,
         events.filter((event) => event.label === mock.label && event.ok !== false).length
       ])),
+      required_hits_by_label: Object.fromEntries(requiredMocks.map((mock) => [
+        mock.label,
+        requiredNetworkMockHitCount(mock)
+      ])),
       failed
     },
     message: failed.length ? `Network mocks failed or were not hit for ${failed.length} mock(s).` : void 0
   };
 }
+function requiredNetworkMockHitCount(mock) {
+  if (mock.required === false) return 0;
+  if (mock.required_hit_count !== void 0) return mock.required_hit_count;
+  if (Array.isArray(mock.responses) && mock.responses.length) return mock.responses.length;
+  return 1;
+}
 function profileStatusFromEvidence(profile, evidence, checks) {
   if (!evidence) return "proof_insufficient";
   const viewports = evidence.viewports || [];
@@ -8096,6 +8142,12 @@ function horizontalBoundsOverflowPx(value) {
   }
   return roundPixels(max);
 }
+function requiredNetworkMockHitCount(mock) {
+  if (!mock || mock.required === false) return 0;
+  if (Number.isInteger(mock.required_hit_count) && mock.required_hit_count > 0) return mock.required_hit_count;
+  if (Array.isArray(mock.responses) && mock.responses.length) return mock.responses.length;
+  return 1;
+}
 function assessProfile(profile, evidence) {
   const checks = [];
   const viewports = evidence.viewports || [];
@@ -8105,12 +8157,15 @@ function assessProfile(profile, evidence) {
     const failed = [];
     for (const mock of requiredMocks) {
       const hits = events.filter((event) => event && event.label === mock.label && event.ok !== false).length;
-      if (hits < 1) {
+      const requiredHitCount = requiredNetworkMockHitCount(mock);
+      if (hits < requiredHitCount) {
         failed.push({
           label: mock.label,
           url: mock.url,
           method: mock.method || null,
-          reason: "required_mock_not_hit",
+          reason: hits < 1 ? "required_mock_not_hit" : "required_mock_hit_count_not_met",
+          required_hit_count: requiredHitCount,
+          hit_count: hits,
         });
       }
     }
@@ -8125,8 +8180,10 @@ function assessProfile(profile, evidence) {
       }
     }
     const hitsByLabel = {};
+    const requiredHitsByLabel = {};
     for (const mock of profile.target.network_mocks) {
       hitsByLabel[mock.label] = events.filter((event) => event && event.label === mock.label && event.ok !== false).length;
+      if (mock && mock.required !== false) requiredHitsByLabel[mock.label] = requiredNetworkMockHitCount(mock);
     }
     checks.push({
       type: "network_mocks_succeeded",
@@ -8137,6 +8194,7 @@ function assessProfile(profile, evidence) {
         required_count: requiredMocks.length,
         hit_count: events.filter((event) => event && event.ok !== false).length,
         hits_by_label: hitsByLabel,
+        required_hits_by_label: requiredHitsByLabel,
         failed,
       },
       message: failed.length ? "Network mocks failed or were not hit for " + failed.length + " mock(s)." : undefined,
@@ -8535,6 +8593,7 @@ async function setupLocatorVisible(locator, index) {
 }
 async function registerNetworkMocks(mocks) {
   for (const mock of mocks || []) {
+    let hitCount = 0;
     await page.route(mock.url, async (route) => {
       const request = route.request();
       const method = request.method ? request.method() : "";
@@ -8543,22 +8602,31 @@ async function registerNetworkMocks(mocks) {
         return;
       }
       try {
-        const headers = { ...(mock.headers || {}) };
-        let body = mock.body || "";
-        let contentType = mock.content_type || headers["content-type"] || headers["Content-Type"] || "text/plain";
-        if (mock.body_json !== undefined) {
-          body = JSON.stringify(mock.body_json);
-          contentType = mock.content_type || headers["content-type"] || headers["Content-Type"] || "application/json";
+        const responses = Array.isArray(mock.responses) ? mock.responses : [];
+        const hitIndex = hitCount;
+        hitCount += 1;
+        const responseIndex = responses.length ? Math.min(hitIndex, responses.length - 1) : null;
+        const response = responseIndex === null ? mock : responses[responseIndex];
+        const headers = { ...(response.headers || mock.headers || {}) };
+        let body = response.body || "";
+        let contentType = response.content_type || headers["content-type"] || headers["Content-Type"] || "text/plain";
+        if (response.body_json !== undefined) {
+          body = JSON.stringify(response.body_json);
+          contentType = response.content_type || headers["content-type"] || headers["Content-Type"] || "application/json";
         }
         networkMockEvents.push({
           ok: true,
           label: mock.label,
+          response_label: response.label || null,
+          hit_index: hitIndex,
+          response_index: responseIndex,
+          sequence_reused: responseIndex !== null && hitIndex >= responses.length,
           url: request.url(),
           method,
-          status: mock.status || 200,
+          status: response.status || mock.status || 200,
         });
         await route.fulfill({
-          status: mock.status || 200,
+          status: response.status || mock.status || 200,
           headers,
           contentType,
           body,

package/dist/cli.js

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

package/dist/index.cjs

@@ -8960,24 +8960,57 @@ function normalizeNetworkMock(input, index) {
   if (!isRecord2(input)) throw new Error(`target.network_mocks[${index}] must be an object.`);
   const url = stringValue5(input.url) || stringValue5(input.glob) || stringValue5(input.pattern);
   if (!url) throw new Error(`target.network_mocks[${index}] requires url.`);
-  const status = numberValue3(input.status) ?? 200;
-  if (!Number.isInteger(status) || status < 100 || status > 599) {
-    throw new Error(`target.network_mocks[${index}].status must be an HTTP status code.`);
+  const payload = normalizeNetworkMockResponsePayload(input, `target.network_mocks[${index}]`);
+  const responsesInput = input.responses ?? input.sequence;
+  const responses = normalizeNetworkMockResponses(responsesInput, index, payload);
+  const requiredHitCount = numberValue3(
+    input.required_hit_count ?? input.requiredHitCount ?? input.required_hits ?? input.requiredHits ?? input.min_hits ?? input.minHits
+  );
+  if (requiredHitCount !== void 0 && (!Number.isInteger(requiredHitCount) || requiredHitCount < 1)) {
+    throw new Error(`target.network_mocks[${index}].required_hit_count must be a positive integer.`);
   }
-  const body = stringValue5(input.body) ?? stringValue5(input.body_text) ?? stringValue5(input.bodyText);
-  const hasJsonBody = Object.prototype.hasOwnProperty.call(input, "body_json") || Object.prototype.hasOwnProperty.call(input, "bodyJson") || Object.prototype.hasOwnProperty.call(input, "json");
   return {
+    ...payload,
     label: normalizeName(input.label || input.name, `network-mock-${index + 1}`),
     url,
     method: stringValue5(input.method)?.toUpperCase(),
+    responses,
+    required_hit_count: requiredHitCount,
+    required: input.required === false ? false : true
+  };
+}
+function normalizeNetworkMockResponsePayload(input, label, defaults = {}) {
+  const status = numberValue3(input.status) ?? defaults.status ?? 200;
+  if (!Number.isInteger(status) || status < 100 || status > 599) {
+    throw new Error(`${label}.status must be an HTTP status code.`);
+  }
+  const body = stringValue5(input.body) ?? stringValue5(input.body_text) ?? stringValue5(input.bodyText) ?? defaults.body;
+  const hasJsonBody = Object.prototype.hasOwnProperty.call(input, "body_json") || Object.prototype.hasOwnProperty.call(input, "bodyJson") || Object.prototype.hasOwnProperty.call(input, "json");
+  return {
+    label: stringValue5(input.label) || stringValue5(input.name) || defaults.label,
     status,
-    content_type: stringValue5(input.content_type) || stringValue5(input.contentType),
-    headers: stringRecord(input.headers),
+    content_type: stringValue5(input.content_type) || stringValue5(input.contentType) || defaults.content_type,
+    headers: stringRecord(input.headers) || defaults.headers,
     body,
-    body_json: hasJsonBody ? toJsonValue(input.body_json ?? input.bodyJson ?? input.json) : void 0,
-    required: input.required === false ? false : true
+    body_json: hasJsonBody ? toJsonValue(input.body_json ?? input.bodyJson ?? input.json) : defaults.body_json
   };
 }
+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.`);
+  if (!value.length) throw new Error(`target.network_mocks[${mockIndex}].responses must not be empty.`);
+  const responseDefaults = { ...defaults, label: void 0 };
+  return value.map((response, responseIndex) => {
+    if (!isRecord2(response)) {
+      throw new Error(`target.network_mocks[${mockIndex}].responses[${responseIndex}] must be an object.`);
+    }
+    return normalizeNetworkMockResponsePayload(
+      response,
+      `target.network_mocks[${mockIndex}].responses[${responseIndex}]`,
+      responseDefaults
+    );
+  });
+}
 function normalizeNetworkMocks(value) {
   if (value === void 0) return void 0;
   if (!Array.isArray(value)) throw new Error("target.network_mocks must be an array.");
@@ -9623,12 +9656,15 @@ function assessNetworkMocksFromEvidence(profile, evidence) {
   const requiredMocks = mocks.filter((mock) => mock.required !== false);
   for (const mock of requiredMocks) {
     const hits = events.filter((event) => event.label === mock.label && event.ok !== false).length;
-    if (hits < 1) {
+    const requiredHitCount = requiredNetworkMockHitCount(mock);
+    if (hits < requiredHitCount) {
       failed.push({
         label: mock.label,
         url: mock.url,
         method: mock.method || null,
-        reason: "required_mock_not_hit"
+        reason: hits < 1 ? "required_mock_not_hit" : "required_mock_hit_count_not_met",
+        required_hit_count: requiredHitCount,
+        hit_count: hits
       });
     }
   }
@@ -9654,11 +9690,21 @@ function assessNetworkMocksFromEvidence(profile, evidence) {
         mock.label,
         events.filter((event) => event.label === mock.label && event.ok !== false).length
       ])),
+      required_hits_by_label: Object.fromEntries(requiredMocks.map((mock) => [
+        mock.label,
+        requiredNetworkMockHitCount(mock)
+      ])),
       failed
     },
     message: failed.length ? `Network mocks failed or were not hit for ${failed.length} mock(s).` : void 0
   };
 }
+function requiredNetworkMockHitCount(mock) {
+  if (mock.required === false) return 0;
+  if (mock.required_hit_count !== void 0) return mock.required_hit_count;
+  if (Array.isArray(mock.responses) && mock.responses.length) return mock.responses.length;
+  return 1;
+}
 function profileStatusFromEvidence(profile, evidence, checks) {
   if (!evidence) return "proof_insufficient";
   const viewports = evidence.viewports || [];
@@ -9953,6 +9999,12 @@ function horizontalBoundsOverflowPx(value) {
   }
   return roundPixels(max);
 }
+function requiredNetworkMockHitCount(mock) {
+  if (!mock || mock.required === false) return 0;
+  if (Number.isInteger(mock.required_hit_count) && mock.required_hit_count > 0) return mock.required_hit_count;
+  if (Array.isArray(mock.responses) && mock.responses.length) return mock.responses.length;
+  return 1;
+}
 function assessProfile(profile, evidence) {
   const checks = [];
   const viewports = evidence.viewports || [];
@@ -9962,12 +10014,15 @@ function assessProfile(profile, evidence) {
     const failed = [];
     for (const mock of requiredMocks) {
       const hits = events.filter((event) => event && event.label === mock.label && event.ok !== false).length;
-      if (hits < 1) {
+      const requiredHitCount = requiredNetworkMockHitCount(mock);
+      if (hits < requiredHitCount) {
         failed.push({
           label: mock.label,
           url: mock.url,
           method: mock.method || null,
-          reason: "required_mock_not_hit",
+          reason: hits < 1 ? "required_mock_not_hit" : "required_mock_hit_count_not_met",
+          required_hit_count: requiredHitCount,
+          hit_count: hits,
         });
       }
     }
@@ -9982,8 +10037,10 @@ function assessProfile(profile, evidence) {
       }
     }
     const hitsByLabel = {};
+    const requiredHitsByLabel = {};
     for (const mock of profile.target.network_mocks) {
       hitsByLabel[mock.label] = events.filter((event) => event && event.label === mock.label && event.ok !== false).length;
+      if (mock && mock.required !== false) requiredHitsByLabel[mock.label] = requiredNetworkMockHitCount(mock);
     }
     checks.push({
       type: "network_mocks_succeeded",
@@ -9994,6 +10051,7 @@ function assessProfile(profile, evidence) {
         required_count: requiredMocks.length,
         hit_count: events.filter((event) => event && event.ok !== false).length,
         hits_by_label: hitsByLabel,
+        required_hits_by_label: requiredHitsByLabel,
         failed,
       },
       message: failed.length ? "Network mocks failed or were not hit for " + failed.length + " mock(s)." : undefined,
@@ -10392,6 +10450,7 @@ async function setupLocatorVisible(locator, index) {
 }
 async function registerNetworkMocks(mocks) {
   for (const mock of mocks || []) {
+    let hitCount = 0;
     await page.route(mock.url, async (route) => {
       const request = route.request();
       const method = request.method ? request.method() : "";
@@ -10400,22 +10459,31 @@ async function registerNetworkMocks(mocks) {
         return;
       }
       try {
-        const headers = { ...(mock.headers || {}) };
-        let body = mock.body || "";
-        let contentType = mock.content_type || headers["content-type"] || headers["Content-Type"] || "text/plain";
-        if (mock.body_json !== undefined) {
-          body = JSON.stringify(mock.body_json);
-          contentType = mock.content_type || headers["content-type"] || headers["Content-Type"] || "application/json";
+        const responses = Array.isArray(mock.responses) ? mock.responses : [];
+        const hitIndex = hitCount;
+        hitCount += 1;
+        const responseIndex = responses.length ? Math.min(hitIndex, responses.length - 1) : null;
+        const response = responseIndex === null ? mock : responses[responseIndex];
+        const headers = { ...(response.headers || mock.headers || {}) };
+        let body = response.body || "";
+        let contentType = response.content_type || headers["content-type"] || headers["Content-Type"] || "text/plain";
+        if (response.body_json !== undefined) {
+          body = JSON.stringify(response.body_json);
+          contentType = response.content_type || headers["content-type"] || headers["Content-Type"] || "application/json";
         }
         networkMockEvents.push({
           ok: true,
           label: mock.label,
+          response_label: response.label || null,
+          hit_index: hitIndex,
+          response_index: responseIndex,
+          sequence_reused: responseIndex !== null && hitIndex >= responses.length,
           url: request.url(),
           method,
-          status: mock.status || 200,
+          status: response.status || mock.status || 200,
         });
         await route.fulfill({
-          status: mock.status || 200,
+          status: response.status || mock.status || 200,
           headers,
           contentType,
           body,

package/dist/index.d.cts

@@ -10,5 +10,5 @@ export { CreateCaptureDiagnosticInput, DEFAULT_DIAGNOSTIC_ARRAY_LIMIT, DEFAULT_D
 export { BuildVisualProofSessionInput, RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION, RIDDLE_PROOF_VISUAL_SESSION_VERSION, VisualProofSessionMismatch, buildVisualProofSession, compareVisualProofSessionFingerprint, parseVisualProofSession, visualSessionFingerprint, visualSessionFingerprintBasis } from './proof-session.cjs';
 export { AssessPlayabilityOptions, RIDDLE_PROOF_PLAYABILITY_ASSESSMENT_VERSION, RIDDLE_PROOF_PLAYABILITY_VERSION, RiddleProofPlayabilityAssessment, RiddleProofPlayabilityEvidence, assessPlayabilityEvidence, extractPlayabilityEvidence, isRiddleProofPlayabilityMode } from './playability.cjs';
 export { AssessBasicGameplayOptions, AttachBasicGameplayArtifactOptions, BASIC_GAMEPLAY_ACTION_TYPES, BASIC_GAMEPLAY_PROGRESS_CHECK_TYPES, BasicGameplayActionResult, BasicGameplayActionType, BasicGameplayArtifactResolution, BasicGameplayAssessmentSummary, BasicGameplayBoundsOffender, BasicGameplayCanvasState, BasicGameplayCatchRecord, BasicGameplayChangeSummary, BasicGameplayFailureCode, BasicGameplayFixReference, BasicGameplayMetric, BasicGameplayMobileEvidence, BasicGameplayProgressCheckType, BasicGameplayProgressionCheck, BasicGameplayProofArtifact, BasicGameplayResponsiveViewportEvidence, BasicGameplayRouteReference, BasicGameplaySnapshot, BasicGameplaySuiteFailure, BasicGameplayWarningCode, CreateBasicGameplayCatchSummaryInput, RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_CATCH_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION, RiddleProofBasicGameplayAssessment, RiddleProofBasicGameplayCatchSummary, RiddleProofBasicGameplayEvidence, RiddleProofBasicGameplayRouteAssessment, RiddleProofBasicGameplayRouteEvidence, assessBasicGameplayEvidence, assessBasicGameplayProgressionCheck, assessBasicGameplayProgressionChecks, assessBasicGameplayRoute, attachBasicGameplayArtifactScreenshotHashes, augmentBasicGameplayAssessmentWithProgressionChecks, compactBasicGameplayText, createBasicGameplayCatchRecords, createBasicGameplayCatchSummary, extractBasicGameplayEvidence, resolveBasicGameplayProgressionCheckWithArtifactScreenshots, sanitizeBasicGameplayJsonString } from './basic-gameplay.cjs';
-export { NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, RiddleProofProfile, RiddleProofProfileArtifactRef, RiddleProofProfileBaselinePolicy, RiddleProofProfileBoundsOffender, RiddleProofProfileCheck, RiddleProofProfileCheckResult, RiddleProofProfileCheckType, RiddleProofProfileEvidence, RiddleProofProfileFailureAction, RiddleProofProfileNetworkMock, RiddleProofProfileResult, RiddleProofProfileRouteEvidence, RiddleProofProfileRouteInventoryRoute, RiddleProofProfileRunner, RiddleProofProfileSetupAction, RiddleProofProfileSetupActionType, RiddleProofProfileStatus, RiddleProofProfileTarget, RiddleProofProfileViewport, RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, extractRiddleProofProfileResult, normalizeRiddleProofProfile, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult } from './profile.cjs';
+export { NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, RiddleProofProfile, RiddleProofProfileArtifactRef, RiddleProofProfileBaselinePolicy, RiddleProofProfileBoundsOffender, RiddleProofProfileCheck, RiddleProofProfileCheckResult, RiddleProofProfileCheckType, RiddleProofProfileEvidence, RiddleProofProfileFailureAction, RiddleProofProfileNetworkMock, RiddleProofProfileNetworkMockResponse, RiddleProofProfileResult, RiddleProofProfileRouteEvidence, RiddleProofProfileRouteInventoryRoute, RiddleProofProfileRunner, RiddleProofProfileSetupAction, RiddleProofProfileSetupActionType, RiddleProofProfileStatus, RiddleProofProfileTarget, RiddleProofProfileViewport, RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, extractRiddleProofProfileResult, normalizeRiddleProofProfile, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult } from './profile.cjs';
 export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, RiddleClientConfig, RiddleFetch, RiddlePollJobOptions, RiddlePollJobResult, RiddlePollProgressSnapshot, RiddlePollSummary, RiddlePreviewDeployResult, RiddleRunScriptInput, RiddleServerPreviewInput, RiddleServerPreviewResult, createRiddleApiClient, deployRiddleStaticPreview, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, riddleRequestJson, runRiddleScript, runRiddleServerPreview } from './riddle-client.cjs';

package/dist/index.d.ts

@@ -10,5 +10,5 @@ export { CreateCaptureDiagnosticInput, DEFAULT_DIAGNOSTIC_ARRAY_LIMIT, DEFAULT_D
 export { BuildVisualProofSessionInput, RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION, RIDDLE_PROOF_VISUAL_SESSION_VERSION, VisualProofSessionMismatch, buildVisualProofSession, compareVisualProofSessionFingerprint, parseVisualProofSession, visualSessionFingerprint, visualSessionFingerprintBasis } from './proof-session.js';
 export { AssessPlayabilityOptions, RIDDLE_PROOF_PLAYABILITY_ASSESSMENT_VERSION, RIDDLE_PROOF_PLAYABILITY_VERSION, RiddleProofPlayabilityAssessment, RiddleProofPlayabilityEvidence, assessPlayabilityEvidence, extractPlayabilityEvidence, isRiddleProofPlayabilityMode } from './playability.js';
 export { AssessBasicGameplayOptions, AttachBasicGameplayArtifactOptions, BASIC_GAMEPLAY_ACTION_TYPES, BASIC_GAMEPLAY_PROGRESS_CHECK_TYPES, BasicGameplayActionResult, BasicGameplayActionType, BasicGameplayArtifactResolution, BasicGameplayAssessmentSummary, BasicGameplayBoundsOffender, BasicGameplayCanvasState, BasicGameplayCatchRecord, BasicGameplayChangeSummary, BasicGameplayFailureCode, BasicGameplayFixReference, BasicGameplayMetric, BasicGameplayMobileEvidence, BasicGameplayProgressCheckType, BasicGameplayProgressionCheck, BasicGameplayProofArtifact, BasicGameplayResponsiveViewportEvidence, BasicGameplayRouteReference, BasicGameplaySnapshot, BasicGameplaySuiteFailure, BasicGameplayWarningCode, CreateBasicGameplayCatchSummaryInput, RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_CATCH_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION, RiddleProofBasicGameplayAssessment, RiddleProofBasicGameplayCatchSummary, RiddleProofBasicGameplayEvidence, RiddleProofBasicGameplayRouteAssessment, RiddleProofBasicGameplayRouteEvidence, assessBasicGameplayEvidence, assessBasicGameplayProgressionCheck, assessBasicGameplayProgressionChecks, assessBasicGameplayRoute, attachBasicGameplayArtifactScreenshotHashes, augmentBasicGameplayAssessmentWithProgressionChecks, compactBasicGameplayText, createBasicGameplayCatchRecords, createBasicGameplayCatchSummary, extractBasicGameplayEvidence, resolveBasicGameplayProgressionCheckWithArtifactScreenshots, sanitizeBasicGameplayJsonString } from './basic-gameplay.js';
-export { NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, RiddleProofProfile, RiddleProofProfileArtifactRef, RiddleProofProfileBaselinePolicy, RiddleProofProfileBoundsOffender, RiddleProofProfileCheck, RiddleProofProfileCheckResult, RiddleProofProfileCheckType, RiddleProofProfileEvidence, RiddleProofProfileFailureAction, RiddleProofProfileNetworkMock, RiddleProofProfileResult, RiddleProofProfileRouteEvidence, RiddleProofProfileRouteInventoryRoute, RiddleProofProfileRunner, RiddleProofProfileSetupAction, RiddleProofProfileSetupActionType, RiddleProofProfileStatus, RiddleProofProfileTarget, RiddleProofProfileViewport, RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, extractRiddleProofProfileResult, normalizeRiddleProofProfile, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult } from './profile.js';
+export { NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, RiddleProofProfile, RiddleProofProfileArtifactRef, RiddleProofProfileBaselinePolicy, RiddleProofProfileBoundsOffender, RiddleProofProfileCheck, RiddleProofProfileCheckResult, RiddleProofProfileCheckType, RiddleProofProfileEvidence, RiddleProofProfileFailureAction, RiddleProofProfileNetworkMock, RiddleProofProfileNetworkMockResponse, RiddleProofProfileResult, RiddleProofProfileRouteEvidence, RiddleProofProfileRouteInventoryRoute, RiddleProofProfileRunner, RiddleProofProfileSetupAction, RiddleProofProfileSetupActionType, RiddleProofProfileStatus, RiddleProofProfileTarget, RiddleProofProfileViewport, RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, extractRiddleProofProfileResult, normalizeRiddleProofProfile, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult } from './profile.js';
 export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, RiddleClientConfig, RiddleFetch, RiddlePollJobOptions, RiddlePollJobResult, RiddlePollProgressSnapshot, RiddlePollSummary, RiddlePreviewDeployResult, RiddleRunScriptInput, RiddleServerPreviewInput, RiddleServerPreviewResult, createRiddleApiClient, deployRiddleStaticPreview, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, riddleRequestJson, runRiddleScript, runRiddleServerPreview } from './riddle-client.js';

package/dist/index.js

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

package/dist/profile.cjs

@@ -289,24 +289,57 @@ function normalizeNetworkMock(input, index) {
   if (!isRecord(input)) throw new Error(`target.network_mocks[${index}] must be an object.`);
   const url = stringValue(input.url) || stringValue(input.glob) || stringValue(input.pattern);
   if (!url) throw new Error(`target.network_mocks[${index}] requires url.`);
-  const status = numberValue(input.status) ?? 200;
-  if (!Number.isInteger(status) || status < 100 || status > 599) {
-    throw new Error(`target.network_mocks[${index}].status must be an HTTP status code.`);
+  const payload = normalizeNetworkMockResponsePayload(input, `target.network_mocks[${index}]`);
+  const responsesInput = input.responses ?? input.sequence;
+  const responses = normalizeNetworkMockResponses(responsesInput, index, payload);
+  const requiredHitCount = numberValue(
+    input.required_hit_count ?? input.requiredHitCount ?? input.required_hits ?? input.requiredHits ?? input.min_hits ?? input.minHits
+  );
+  if (requiredHitCount !== void 0 && (!Number.isInteger(requiredHitCount) || requiredHitCount < 1)) {
+    throw new Error(`target.network_mocks[${index}].required_hit_count must be a positive integer.`);
   }
-  const body = stringValue(input.body) ?? stringValue(input.body_text) ?? stringValue(input.bodyText);
-  const hasJsonBody = Object.prototype.hasOwnProperty.call(input, "body_json") || Object.prototype.hasOwnProperty.call(input, "bodyJson") || Object.prototype.hasOwnProperty.call(input, "json");
   return {
+    ...payload,
     label: normalizeName(input.label || input.name, `network-mock-${index + 1}`),
     url,
     method: stringValue(input.method)?.toUpperCase(),
+    responses,
+    required_hit_count: requiredHitCount,
+    required: input.required === false ? false : true
+  };
+}
+function normalizeNetworkMockResponsePayload(input, label, defaults = {}) {
+  const status = numberValue(input.status) ?? defaults.status ?? 200;
+  if (!Number.isInteger(status) || status < 100 || status > 599) {
+    throw new Error(`${label}.status must be an HTTP status code.`);
+  }
+  const body = stringValue(input.body) ?? stringValue(input.body_text) ?? stringValue(input.bodyText) ?? defaults.body;
+  const hasJsonBody = Object.prototype.hasOwnProperty.call(input, "body_json") || Object.prototype.hasOwnProperty.call(input, "bodyJson") || Object.prototype.hasOwnProperty.call(input, "json");
+  return {
+    label: stringValue(input.label) || stringValue(input.name) || defaults.label,
     status,
-    content_type: stringValue(input.content_type) || stringValue(input.contentType),
-    headers: stringRecord(input.headers),
+    content_type: stringValue(input.content_type) || stringValue(input.contentType) || defaults.content_type,
+    headers: stringRecord(input.headers) || defaults.headers,
     body,
-    body_json: hasJsonBody ? toJsonValue(input.body_json ?? input.bodyJson ?? input.json) : void 0,
-    required: input.required === false ? false : true
+    body_json: hasJsonBody ? toJsonValue(input.body_json ?? input.bodyJson ?? input.json) : defaults.body_json
   };
 }
+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.`);
+  if (!value.length) throw new Error(`target.network_mocks[${mockIndex}].responses must not be empty.`);
+  const responseDefaults = { ...defaults, label: void 0 };
+  return value.map((response, responseIndex) => {
+    if (!isRecord(response)) {
+      throw new Error(`target.network_mocks[${mockIndex}].responses[${responseIndex}] must be an object.`);
+    }
+    return normalizeNetworkMockResponsePayload(
+      response,
+      `target.network_mocks[${mockIndex}].responses[${responseIndex}]`,
+      responseDefaults
+    );
+  });
+}
 function normalizeNetworkMocks(value) {
   if (value === void 0) return void 0;
   if (!Array.isArray(value)) throw new Error("target.network_mocks must be an array.");
@@ -952,12 +985,15 @@ function assessNetworkMocksFromEvidence(profile, evidence) {
   const requiredMocks = mocks.filter((mock) => mock.required !== false);
   for (const mock of requiredMocks) {
     const hits = events.filter((event) => event.label === mock.label && event.ok !== false).length;
-    if (hits < 1) {
+    const requiredHitCount = requiredNetworkMockHitCount(mock);
+    if (hits < requiredHitCount) {
       failed.push({
         label: mock.label,
         url: mock.url,
         method: mock.method || null,
-        reason: "required_mock_not_hit"
+        reason: hits < 1 ? "required_mock_not_hit" : "required_mock_hit_count_not_met",
+        required_hit_count: requiredHitCount,
+        hit_count: hits
       });
     }
   }
@@ -983,11 +1019,21 @@ function assessNetworkMocksFromEvidence(profile, evidence) {
         mock.label,
         events.filter((event) => event.label === mock.label && event.ok !== false).length
       ])),
+      required_hits_by_label: Object.fromEntries(requiredMocks.map((mock) => [
+        mock.label,
+        requiredNetworkMockHitCount(mock)
+      ])),
       failed
     },
     message: failed.length ? `Network mocks failed or were not hit for ${failed.length} mock(s).` : void 0
   };
 }
+function requiredNetworkMockHitCount(mock) {
+  if (mock.required === false) return 0;
+  if (mock.required_hit_count !== void 0) return mock.required_hit_count;
+  if (Array.isArray(mock.responses) && mock.responses.length) return mock.responses.length;
+  return 1;
+}
 function profileStatusFromEvidence(profile, evidence, checks) {
   if (!evidence) return "proof_insufficient";
   const viewports = evidence.viewports || [];
@@ -1282,6 +1328,12 @@ function horizontalBoundsOverflowPx(value) {
   }
   return roundPixels(max);
 }
+function requiredNetworkMockHitCount(mock) {
+  if (!mock || mock.required === false) return 0;
+  if (Number.isInteger(mock.required_hit_count) && mock.required_hit_count > 0) return mock.required_hit_count;
+  if (Array.isArray(mock.responses) && mock.responses.length) return mock.responses.length;
+  return 1;
+}
 function assessProfile(profile, evidence) {
   const checks = [];
   const viewports = evidence.viewports || [];
@@ -1291,12 +1343,15 @@ function assessProfile(profile, evidence) {
     const failed = [];
     for (const mock of requiredMocks) {
       const hits = events.filter((event) => event && event.label === mock.label && event.ok !== false).length;
-      if (hits < 1) {
+      const requiredHitCount = requiredNetworkMockHitCount(mock);
+      if (hits < requiredHitCount) {
         failed.push({
           label: mock.label,
           url: mock.url,
           method: mock.method || null,
-          reason: "required_mock_not_hit",
+          reason: hits < 1 ? "required_mock_not_hit" : "required_mock_hit_count_not_met",
+          required_hit_count: requiredHitCount,
+          hit_count: hits,
         });
       }
     }
@@ -1311,8 +1366,10 @@ function assessProfile(profile, evidence) {
       }
     }
     const hitsByLabel = {};
+    const requiredHitsByLabel = {};
     for (const mock of profile.target.network_mocks) {
       hitsByLabel[mock.label] = events.filter((event) => event && event.label === mock.label && event.ok !== false).length;
+      if (mock && mock.required !== false) requiredHitsByLabel[mock.label] = requiredNetworkMockHitCount(mock);
     }
     checks.push({
       type: "network_mocks_succeeded",
@@ -1323,6 +1380,7 @@ function assessProfile(profile, evidence) {
         required_count: requiredMocks.length,
         hit_count: events.filter((event) => event && event.ok !== false).length,
         hits_by_label: hitsByLabel,
+        required_hits_by_label: requiredHitsByLabel,
         failed,
       },
       message: failed.length ? "Network mocks failed or were not hit for " + failed.length + " mock(s)." : undefined,
@@ -1721,6 +1779,7 @@ async function setupLocatorVisible(locator, index) {
 }
 async function registerNetworkMocks(mocks) {
   for (const mock of mocks || []) {
+    let hitCount = 0;
     await page.route(mock.url, async (route) => {
       const request = route.request();
       const method = request.method ? request.method() : "";
@@ -1729,22 +1788,31 @@ async function registerNetworkMocks(mocks) {
         return;
       }
       try {
-        const headers = { ...(mock.headers || {}) };
-        let body = mock.body || "";
-        let contentType = mock.content_type || headers["content-type"] || headers["Content-Type"] || "text/plain";
-        if (mock.body_json !== undefined) {
-          body = JSON.stringify(mock.body_json);
-          contentType = mock.content_type || headers["content-type"] || headers["Content-Type"] || "application/json";
+        const responses = Array.isArray(mock.responses) ? mock.responses : [];
+        const hitIndex = hitCount;
+        hitCount += 1;
+        const responseIndex = responses.length ? Math.min(hitIndex, responses.length - 1) : null;
+        const response = responseIndex === null ? mock : responses[responseIndex];
+        const headers = { ...(response.headers || mock.headers || {}) };
+        let body = response.body || "";
+        let contentType = response.content_type || headers["content-type"] || headers["Content-Type"] || "text/plain";
+        if (response.body_json !== undefined) {
+          body = JSON.stringify(response.body_json);
+          contentType = response.content_type || headers["content-type"] || headers["Content-Type"] || "application/json";
         }
         networkMockEvents.push({
           ok: true,
           label: mock.label,
+          response_label: response.label || null,
+          hit_index: hitIndex,
+          response_index: responseIndex,
+          sequence_reused: responseIndex !== null && hitIndex >= responses.length,
           url: request.url(),
           method,
-          status: mock.status || 200,
+          status: response.status || mock.status || 200,
         });
         await route.fulfill({
-          status: mock.status || 200,
+          status: response.status || mock.status || 200,
           headers,
           contentType,
           body,

package/dist/profile.d.cts

@@ -34,15 +34,20 @@ interface RiddleProofProfileSetupAction {
     storage?: "local" | "session" | "both";
     continue_on_failure?: boolean;
 }
-interface RiddleProofProfileNetworkMock {
-    label: string;
-    url: string;
-    method?: string;
+interface RiddleProofProfileNetworkMockResponse {
+    label?: string;
     status: number;
     content_type?: string;
     headers?: Record<string, string>;
     body?: string;
     body_json?: JsonValue;
+}
+interface RiddleProofProfileNetworkMock extends RiddleProofProfileNetworkMockResponse {
+    label: string;
+    url: string;
+    method?: string;
+    responses?: RiddleProofProfileNetworkMockResponse[];
+    required_hit_count?: number;
     required?: boolean;
 }
 interface RiddleProofProfileRouteInventoryRoute {
@@ -254,4 +259,4 @@ declare function buildRiddleProofProfileScript(profile: RiddleProofProfile): str
 declare function collectRiddleProfileArtifactRefs(input: unknown): RiddleProofProfileArtifactRef[];
 declare function extractRiddleProofProfileResult(input: unknown): RiddleProofProfileResult | undefined;
 
-export { type NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, type RiddleProofProfile, type RiddleProofProfileArtifactRef, type RiddleProofProfileBaselinePolicy, type RiddleProofProfileBoundsOffender, type RiddleProofProfileCheck, type RiddleProofProfileCheckResult, type RiddleProofProfileCheckType, type RiddleProofProfileEvidence, type RiddleProofProfileFailureAction, type RiddleProofProfileNetworkMock, type RiddleProofProfileResult, type RiddleProofProfileRouteEvidence, type RiddleProofProfileRouteInventoryRoute, type RiddleProofProfileRunner, type RiddleProofProfileSetupAction, type RiddleProofProfileSetupActionType, type RiddleProofProfileStatus, type RiddleProofProfileTarget, type RiddleProofProfileViewport, type RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, extractRiddleProofProfileResult, normalizeRiddleProofProfile, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult };
+export { type NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, type RiddleProofProfile, type RiddleProofProfileArtifactRef, type RiddleProofProfileBaselinePolicy, type RiddleProofProfileBoundsOffender, type RiddleProofProfileCheck, type RiddleProofProfileCheckResult, type RiddleProofProfileCheckType, type RiddleProofProfileEvidence, type RiddleProofProfileFailureAction, type RiddleProofProfileNetworkMock, type RiddleProofProfileNetworkMockResponse, type RiddleProofProfileResult, type RiddleProofProfileRouteEvidence, type RiddleProofProfileRouteInventoryRoute, type RiddleProofProfileRunner, type RiddleProofProfileSetupAction, type RiddleProofProfileSetupActionType, type RiddleProofProfileStatus, type RiddleProofProfileTarget, type RiddleProofProfileViewport, type RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, extractRiddleProofProfileResult, normalizeRiddleProofProfile, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult };

package/dist/profile.d.ts

@@ -34,15 +34,20 @@ interface RiddleProofProfileSetupAction {
     storage?: "local" | "session" | "both";
     continue_on_failure?: boolean;
 }
-interface RiddleProofProfileNetworkMock {
-    label: string;
-    url: string;
-    method?: string;
+interface RiddleProofProfileNetworkMockResponse {
+    label?: string;
     status: number;
     content_type?: string;
     headers?: Record<string, string>;
     body?: string;
     body_json?: JsonValue;
+}
+interface RiddleProofProfileNetworkMock extends RiddleProofProfileNetworkMockResponse {
+    label: string;
+    url: string;
+    method?: string;
+    responses?: RiddleProofProfileNetworkMockResponse[];
+    required_hit_count?: number;
     required?: boolean;
 }
 interface RiddleProofProfileRouteInventoryRoute {
@@ -254,4 +259,4 @@ declare function buildRiddleProofProfileScript(profile: RiddleProofProfile): str
 declare function collectRiddleProfileArtifactRefs(input: unknown): RiddleProofProfileArtifactRef[];
 declare function extractRiddleProofProfileResult(input: unknown): RiddleProofProfileResult | undefined;
 
-export { type NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, type RiddleProofProfile, type RiddleProofProfileArtifactRef, type RiddleProofProfileBaselinePolicy, type RiddleProofProfileBoundsOffender, type RiddleProofProfileCheck, type RiddleProofProfileCheckResult, type RiddleProofProfileCheckType, type RiddleProofProfileEvidence, type RiddleProofProfileFailureAction, type RiddleProofProfileNetworkMock, type RiddleProofProfileResult, type RiddleProofProfileRouteEvidence, type RiddleProofProfileRouteInventoryRoute, type RiddleProofProfileRunner, type RiddleProofProfileSetupAction, type RiddleProofProfileSetupActionType, type RiddleProofProfileStatus, type RiddleProofProfileTarget, type RiddleProofProfileViewport, type RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, extractRiddleProofProfileResult, normalizeRiddleProofProfile, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult };
+export { type NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, type RiddleProofProfile, type RiddleProofProfileArtifactRef, type RiddleProofProfileBaselinePolicy, type RiddleProofProfileBoundsOffender, type RiddleProofProfileCheck, type RiddleProofProfileCheckResult, type RiddleProofProfileCheckType, type RiddleProofProfileEvidence, type RiddleProofProfileFailureAction, type RiddleProofProfileNetworkMock, type RiddleProofProfileNetworkMockResponse, type RiddleProofProfileResult, type RiddleProofProfileRouteEvidence, type RiddleProofProfileRouteInventoryRoute, type RiddleProofProfileRunner, type RiddleProofProfileSetupAction, type RiddleProofProfileSetupActionType, type RiddleProofProfileStatus, type RiddleProofProfileTarget, type RiddleProofProfileViewport, type RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, extractRiddleProofProfileResult, normalizeRiddleProofProfile, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult };

package/dist/profile.js

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

package/package.json

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