@adcp/sdk 17.0.0-beta.5 → 17.0.0-beta.7

package/dist/lib/testing/storyboard/seeding.js

@@ -20,12 +20,14 @@ var seeding_exports = {};
 __export(seeding_exports, {
   CONTROLLER_SEEDING_PHASE_ID: () => CONTROLLER_SEEDING_PHASE_ID,
   buildSeedCalls: () => buildSeedCalls,
+  collectWholesaleProductPages: () => collectWholesaleProductPages,
   runControllerSeeding: () => runControllerSeeding
 });
 module.exports = __toCommonJS(seeding_exports);
 var import_client = require('../client.js');
 var import_schema_loader = require('../../validation/schema-loader.js');
 var import_version = require('../../version.js');
+var import_creative_delivery = require('../../v2/projection/creative-delivery.js');
 var import_envelope_status_compat = require('../../utils/envelope-status-compat.js');
 var import_response_unwrapper = require('../../utils/response-unwrapper.js');
 var import_test_controller = require('../test-controller.js');
@@ -1021,7 +1023,7 @@ function resolveDiscoverySchemaIdentity(adcpVersion) {
 }
 function describeDiscoverySchemaFailure(data, options) {
   try {
-    const version = options.adcpVersion ?? import_version.ADCP_VERSION;
+    const version = options._serverAdcpVersion ?? options.adcpVersion ?? import_version.ADCP_VERSION;
     const validator = (0, import_schema_loader.getValidator)("get_products", "sync", version);
     let detail;
     if (validator) {
@@ -1029,7 +1031,7 @@ function describeDiscoverySchemaFailure(data, options) {
       if (validator(schemaData)) return void 0;
       detail = (validator.errors ?? []).map((error) => `${error.instancePath || "/"} ${error.message ?? error.keyword}`).join("; ");
     } else {
-      const schema = (0, import_client.validateResponseSchema)("get_products", data, options.adcpVersion);
+      const schema = (0, import_client.validateResponseSchema)("get_products", data, version);
       if (schema.passed) return void 0;
       detail = schema.error ?? schema.details ?? "schema validation failed";
     }
@@ -1047,20 +1049,38 @@ async function discoverProductCatalog(client, options, context) {
   }
   const accountBrand = isPlainRecord(account.brand) ? account.brand : void 0;
   const brand = isPlainRecord(context.brand) ? context.brand : accountBrand ?? (0, import_client.resolveBrand)(options);
+  const query = structuredClone({
+    buying_mode: "wholesale",
+    brand,
+    account,
+    pagination: { max_results: 100 },
+    ...(0, import_creative_delivery.resolveCreativeFormatWireMode)(
+      options._profile?.raw_capabilities,
+      options._serverAdcpVersion ?? options.adcpVersion ?? import_version.ADCP_VERSION
+    ) === "canonical" && { ext: { adcp: { creative_wire: "canonical" } } }
+  });
+  return collectWholesaleProductPages(client, options, query);
+}
+async function collectWholesaleProductPages(client, options, query, controls = {}) {
+  if (Object.hasOwn(query, "idempotency_key")) {
+    return {
+      ok: false,
+      error: "fixture discovery requires fresh reads without idempotency_key; pagination changes the request body"
+    };
+  }
+  const dispatch = controls.dispatch ?? ((request) => (0, import_task_map.executeStoryboardTask)(client, "get_products", request, { signal: options.signal }));
   const products = [];
+  const errors = [];
   const seenProductIds = /* @__PURE__ */ new Set();
   const cursors = [];
   const seenCursors = /* @__PURE__ */ new Set();
-  let cursor;
+  const initialPagination = isPlainRecord(query.pagination) ? query.pagination : void 0;
+  const initialCursor = typeof initialPagination?.cursor === "string" ? initialPagination.cursor : void 0;
+  let cursor = initialCursor;
+  let firstPage;
   let pageCount = 0;
   let restarts = 0;
   let feedIdentity;
-  const query = structuredClone({
-    buying_mode: "wholesale",
-    brand,
-    account,
-    ext: { adcp: { creative_wire: "canonical" } }
-  });
   let lastExchange;
   const exchanges = [];
   const pageOfProduct = /* @__PURE__ */ new Map();
@@ -1077,7 +1097,7 @@ async function discoverProductCatalog(client, options, context) {
     }
     const request = {
       ...structuredClone(query),
-      pagination: { max_results: 100, ...cursor && { cursor } }
+      ...cursor !== void 0 && { pagination: { ...initialPagination, cursor } }
     };
     let result;
     let observedResponse;
@@ -1090,17 +1110,31 @@ async function discoverProductCatalog(client, options, context) {
     };
     try {
       if (options.protocol === "a2a") {
-        const captured = await (0, import_rawResponseCapture.withRawResponseCapture)(
-          () => (0, import_task_map.executeStoryboardTask)(client, "get_products", request, { signal: options.signal }),
-          { maxBodyBytes: 65536, maxCaptures: 8, maxTotalBodyBytes: 262144 }
-        );
+        const captured = await (0, import_rawResponseCapture.withRawResponseCapture)(() => dispatch(request), {
+          maxBodyBytes: 65536,
+          maxCaptures: 8,
+          maxTotalBodyBytes: 262144
+        });
         result = captured.result;
         observedResponse = toolResponse(captured.captures);
       } else {
-        result = await (0, import_task_map.executeStoryboardTask)(client, "get_products", request, { signal: options.signal });
+        result = await dispatch(request);
       }
     } catch (err) {
       const observed = toolResponse((0, import_rawResponseCapture.getCapturesFromError)(err) ?? []);
+      await controls.onPage?.({
+        page_index: pageCount + 1,
+        restart_count: restarts,
+        request: requestRecord,
+        response: observed ? {
+          transport: requestRecord.transport,
+          payload: (0, import_discovery_evidence.redactDiscoveryEvidence)(observed.body),
+          status: observed.status,
+          duration_ms: Date.now() - pageStart
+        } : null,
+        extraction: { path: "none" },
+        schema_validated: false
+      });
       return {
         ok: false,
         error: `fixture discovery transport failure: ${(0, import_redact_credential_patterns.redactCredentialPatterns)(err instanceof Error ? err.message : String(err), false)}`,
@@ -1128,6 +1162,15 @@ async function discoverProductCatalog(client, options, context) {
       }
     }
     if ((!result.success || result.data === void 0) && result._extraction_path === void 0 && observedResponse === void 0 && wireResponse === void 0) {
+      await controls.onPage?.({
+        page_index: pageCount,
+        restart_count: restarts,
+        request: requestRecord,
+        response: null,
+        extraction: { path: "none" },
+        result,
+        schema_validated: false
+      });
       return {
         ok: false,
         error: `fixture discovery get_products rejected: ${(0, import_redact_credential_patterns.redactCredentialPatterns)(result.error ?? result.adcp_error?.code ?? "unknown error", false)}`,
@@ -1174,7 +1217,21 @@ async function discoverProductCatalog(client, options, context) {
     const nativeState = nativeResult && isPlainRecord(nativeResult.status) ? nativeResult.status.state : void 0;
     const sellerRejected = result._extraction_path === "error" || isPlainRecord(schemaData) && (schemaData.adcp_error !== void 0 || schemaData.status === "failed" || schemaData.status === "rejected") || nativeState === "failed" || nativeState === "rejected" || nativeState === "canceled";
     const schemaCheck = sellerRejected || schemaData === void 0 ? void 0 : describeDiscoverySchemaFailure(schemaData, options);
-    if (!result.success) {
+    const observation = {
+      page_index: pageCount,
+      restart_count: restarts,
+      request: requestRecord,
+      response: failedExchange.response,
+      extraction,
+      result,
+      schema_validated: schemaCheck === void 0 && !sellerRejected && result.success,
+      ...!schemaCheck && !sellerRejected && result.success && {
+        strict_schema_validated: (0, import_schema_loader.getValidator)("get_products", "sync", options._serverAdcpVersion ?? options.adcpVersion ?? import_version.ADCP_VERSION) !== void 0
+      },
+      ...schemaCheck?.schemaFailure && { schemaFailure: schemaCheck.schemaFailure }
+    };
+    await controls.onPage?.(observation);
+    if (!result.success || sellerRejected) {
       return {
         ok: false,
         error: `fixture discovery get_products rejected: ${(0, import_redact_credential_patterns.redactCredentialPatterns)(result.error ?? result.adcp_error?.code ?? "unknown error", false)}`,
@@ -1230,16 +1287,29 @@ async function discoverProductCatalog(client, options, context) {
       }
       restarts++;
       products.length = 0;
+      errors.length = 0;
       seenProductIds.clear();
       cursors.length = 0;
       seenCursors.clear();
-      exchanges.length = 0;
+      if (!controls.retainRestartEvidence) exchanges.length = 0;
       pageOfProduct.clear();
-      cursor = void 0;
+      firstPage = void 0;
+      cursor = initialCursor;
       feedIdentity = void 0;
       continue;
     }
     feedIdentity = identity;
+    firstPage ??= observation;
+    if (Array.isArray(result.data.errors)) {
+      if (errors.length + result.data.errors.length > 1e5) {
+        return {
+          ok: false,
+          error: "fixture discovery exceeded the 100,000-advisory safety limit",
+          exchange: failedExchange
+        };
+      }
+      for (const error of result.data.errors) errors.push(error);
+    }
     const pageProducts = result.data.products;
     if (pageProducts !== void 0 && !Array.isArray(pageProducts)) {
       return {
@@ -1305,6 +1375,8 @@ async function discoverProductCatalog(client, options, context) {
     ok: true,
     catalog: {
       products,
+      firstPage,
+      errors,
       evidence: {
         page_count: pageCount,
         product_count: products.length,
@@ -1600,5 +1672,6 @@ function buildMissingControllerResult(storyboard, calls, context) {
 0 && (module.exports = {
   CONTROLLER_SEEDING_PHASE_ID,
   buildSeedCalls,
+  collectWholesaleProductPages,
   runControllerSeeding
 });

package/dist/lib/testing/storyboard/seeding.mjs

@@ -1,6 +1,7 @@
 import { resolveAccount, resolveBrand, validateResponseSchema } from "../client.mjs";
 import { getValidator } from "../../validation/schema-loader.mjs";
 import { ADCP_VERSION } from "../../version.mjs";
+import { resolveCreativeFormatWireMode } from "../../v2/projection/creative-delivery.mjs";
 import { injectLegacyEnvelopeStatus } from "../../utils/envelope-status-compat.mjs";
 import { readExtractionPath, unwrapProtocolResponse } from "../../utils/response-unwrapper.mjs";
 import { callControllerRaw } from "../test-controller.mjs";
@@ -1002,7 +1003,7 @@ function resolveDiscoverySchemaIdentity(adcpVersion) {
 }
 function describeDiscoverySchemaFailure(data, options) {
   try {
-    const version = options.adcpVersion ?? ADCP_VERSION;
+    const version = options._serverAdcpVersion ?? options.adcpVersion ?? ADCP_VERSION;
     const validator = getValidator("get_products", "sync", version);
     let detail;
     if (validator) {
@@ -1010,7 +1011,7 @@ function describeDiscoverySchemaFailure(data, options) {
       if (validator(schemaData)) return void 0;
       detail = (validator.errors ?? []).map((error) => `${error.instancePath || "/"} ${error.message ?? error.keyword}`).join("; ");
     } else {
-      const schema = validateResponseSchema("get_products", data, options.adcpVersion);
+      const schema = validateResponseSchema("get_products", data, version);
       if (schema.passed) return void 0;
       detail = schema.error ?? schema.details ?? "schema validation failed";
     }
@@ -1028,20 +1029,38 @@ async function discoverProductCatalog(client, options, context) {
   }
   const accountBrand = isPlainRecord(account.brand) ? account.brand : void 0;
   const brand = isPlainRecord(context.brand) ? context.brand : accountBrand ?? resolveBrand(options);
+  const query = structuredClone({
+    buying_mode: "wholesale",
+    brand,
+    account,
+    pagination: { max_results: 100 },
+    ...resolveCreativeFormatWireMode(
+      options._profile?.raw_capabilities,
+      options._serverAdcpVersion ?? options.adcpVersion ?? ADCP_VERSION
+    ) === "canonical" && { ext: { adcp: { creative_wire: "canonical" } } }
+  });
+  return collectWholesaleProductPages(client, options, query);
+}
+async function collectWholesaleProductPages(client, options, query, controls = {}) {
+  if (Object.hasOwn(query, "idempotency_key")) {
+    return {
+      ok: false,
+      error: "fixture discovery requires fresh reads without idempotency_key; pagination changes the request body"
+    };
+  }
+  const dispatch = controls.dispatch ?? ((request) => executeStoryboardTask(client, "get_products", request, { signal: options.signal }));
   const products = [];
+  const errors = [];
   const seenProductIds = /* @__PURE__ */ new Set();
   const cursors = [];
   const seenCursors = /* @__PURE__ */ new Set();
-  let cursor;
+  const initialPagination = isPlainRecord(query.pagination) ? query.pagination : void 0;
+  const initialCursor = typeof initialPagination?.cursor === "string" ? initialPagination.cursor : void 0;
+  let cursor = initialCursor;
+  let firstPage;
   let pageCount = 0;
   let restarts = 0;
   let feedIdentity;
-  const query = structuredClone({
-    buying_mode: "wholesale",
-    brand,
-    account,
-    ext: { adcp: { creative_wire: "canonical" } }
-  });
   let lastExchange;
   const exchanges = [];
   const pageOfProduct = /* @__PURE__ */ new Map();
@@ -1058,7 +1077,7 @@ async function discoverProductCatalog(client, options, context) {
     }
     const request = {
       ...structuredClone(query),
-      pagination: { max_results: 100, ...cursor && { cursor } }
+      ...cursor !== void 0 && { pagination: { ...initialPagination, cursor } }
     };
     let result;
     let observedResponse;
@@ -1071,17 +1090,31 @@ async function discoverProductCatalog(client, options, context) {
     };
     try {
       if (options.protocol === "a2a") {
-        const captured = await withRawResponseCapture(
-          () => executeStoryboardTask(client, "get_products", request, { signal: options.signal }),
-          { maxBodyBytes: 65536, maxCaptures: 8, maxTotalBodyBytes: 262144 }
-        );
+        const captured = await withRawResponseCapture(() => dispatch(request), {
+          maxBodyBytes: 65536,
+          maxCaptures: 8,
+          maxTotalBodyBytes: 262144
+        });
         result = captured.result;
         observedResponse = toolResponse(captured.captures);
       } else {
-        result = await executeStoryboardTask(client, "get_products", request, { signal: options.signal });
+        result = await dispatch(request);
       }
     } catch (err) {
       const observed = toolResponse(getCapturesFromError(err) ?? []);
+      await controls.onPage?.({
+        page_index: pageCount + 1,
+        restart_count: restarts,
+        request: requestRecord,
+        response: observed ? {
+          transport: requestRecord.transport,
+          payload: redactDiscoveryResponse(observed.body),
+          status: observed.status,
+          duration_ms: Date.now() - pageStart
+        } : null,
+        extraction: { path: "none" },
+        schema_validated: false
+      });
       return {
         ok: false,
         error: `fixture discovery transport failure: ${redactCredentialPatterns(err instanceof Error ? err.message : String(err), false)}`,
@@ -1109,6 +1142,15 @@ async function discoverProductCatalog(client, options, context) {
       }
     }
     if ((!result.success || result.data === void 0) && result._extraction_path === void 0 && observedResponse === void 0 && wireResponse === void 0) {
+      await controls.onPage?.({
+        page_index: pageCount,
+        restart_count: restarts,
+        request: requestRecord,
+        response: null,
+        extraction: { path: "none" },
+        result,
+        schema_validated: false
+      });
       return {
         ok: false,
         error: `fixture discovery get_products rejected: ${redactCredentialPatterns(result.error ?? result.adcp_error?.code ?? "unknown error", false)}`,
@@ -1155,7 +1197,21 @@ async function discoverProductCatalog(client, options, context) {
     const nativeState = nativeResult && isPlainRecord(nativeResult.status) ? nativeResult.status.state : void 0;
     const sellerRejected = result._extraction_path === "error" || isPlainRecord(schemaData) && (schemaData.adcp_error !== void 0 || schemaData.status === "failed" || schemaData.status === "rejected") || nativeState === "failed" || nativeState === "rejected" || nativeState === "canceled";
     const schemaCheck = sellerRejected || schemaData === void 0 ? void 0 : describeDiscoverySchemaFailure(schemaData, options);
-    if (!result.success) {
+    const observation = {
+      page_index: pageCount,
+      restart_count: restarts,
+      request: requestRecord,
+      response: failedExchange.response,
+      extraction,
+      result,
+      schema_validated: schemaCheck === void 0 && !sellerRejected && result.success,
+      ...!schemaCheck && !sellerRejected && result.success && {
+        strict_schema_validated: getValidator("get_products", "sync", options._serverAdcpVersion ?? options.adcpVersion ?? ADCP_VERSION) !== void 0
+      },
+      ...schemaCheck?.schemaFailure && { schemaFailure: schemaCheck.schemaFailure }
+    };
+    await controls.onPage?.(observation);
+    if (!result.success || sellerRejected) {
       return {
         ok: false,
         error: `fixture discovery get_products rejected: ${redactCredentialPatterns(result.error ?? result.adcp_error?.code ?? "unknown error", false)}`,
@@ -1211,16 +1267,29 @@ async function discoverProductCatalog(client, options, context) {
       }
       restarts++;
       products.length = 0;
+      errors.length = 0;
       seenProductIds.clear();
       cursors.length = 0;
       seenCursors.clear();
-      exchanges.length = 0;
+      if (!controls.retainRestartEvidence) exchanges.length = 0;
       pageOfProduct.clear();
-      cursor = void 0;
+      firstPage = void 0;
+      cursor = initialCursor;
       feedIdentity = void 0;
       continue;
     }
     feedIdentity = identity;
+    firstPage ??= observation;
+    if (Array.isArray(result.data.errors)) {
+      if (errors.length + result.data.errors.length > 1e5) {
+        return {
+          ok: false,
+          error: "fixture discovery exceeded the 100,000-advisory safety limit",
+          exchange: failedExchange
+        };
+      }
+      for (const error of result.data.errors) errors.push(error);
+    }
     const pageProducts = result.data.products;
     if (pageProducts !== void 0 && !Array.isArray(pageProducts)) {
       return {
@@ -1286,6 +1355,8 @@ async function discoverProductCatalog(client, options, context) {
     ok: true,
     catalog: {
       products,
+      firstPage,
+      errors,
       evidence: {
         page_count: pageCount,
         product_count: products.length,
@@ -1580,5 +1651,6 @@ function buildMissingControllerResult(storyboard, calls, context) {
 export {
   CONTROLLER_SEEDING_PHASE_ID,
   buildSeedCalls,
+  collectWholesaleProductPages,
   runControllerSeeding
 };

package/dist/lib/testing/storyboard/types.d.mts

@@ -88,6 +88,8 @@ export interface Storyboard {
      *     staging fixture). The runner does not verify the assertion;
      *     scenarios that need state still fail naturally if the seed is
      *     not actually present.
+     *   - `collect_product_pages_runner` — intrinsic support for explicit wholesale
+     *     all-page steps; unavailable on older runners that ignore this metadata.
      *   - `real_wire` — always available. Tag scenarios that observe
      *     production behavior with this when you want them excluded from
      *     a future `--mock-only` mode; today the tag is a no-op gate.
@@ -797,6 +799,14 @@ export interface StoryboardStep {
      * fields from the same seller response without changing the request wire.
      */
     response_projection?: 'raw';
+    /**
+     * Follow every wholesale product page before authored checks and captures.
+     * Requires `collect_product_pages_runner` in the storyboard's `requires`.
+     * Reads must omit idempotency_key; each page/restart is a fresh request.
+     * Every page retains its own exchange and is schema/invariant checked; the
+     * combined logical view is explicitly separate from the wire response.
+     */
+    collect_product_pages?: true;
     /** Whether this step depends on state from a previous step */
     stateful?: boolean;
     /**
@@ -2391,7 +2401,7 @@ export interface RunnerSelectionResult {
  *
  * Spec: adcp-client#1626, adcp-client#2281, adcp-client#2356.
  */
-export type RequirementName = 'controller' | 'seeded_state' | 'real_wire' | 'webhook_receiver' | 'webhook_replay_receiver' | 'trusted_match_context_router_runner' | 'trusted_match_publisher_auth_runner' | 'property_list_reference_runner' | 'request_signer' | 'multi_agent';
+export type RequirementName = 'controller' | 'collect_product_pages_runner' | 'seeded_state' | 'real_wire' | 'webhook_receiver' | 'webhook_replay_receiver' | 'trusted_match_context_router_runner' | 'trusted_match_publisher_auth_runner' | 'property_list_reference_runner' | 'request_signer' | 'multi_agent';
 /**
  * Enumeration of every requirement this SDK knows how to satisfy. The loader
  * accepts other non-empty strings for forward compatibility; the runner treats
@@ -2728,6 +2738,8 @@ export interface StoryboardStepResult {
     request?: RunnerRequestRecord;
     /** Exact response observed, including transport, status, headers. */
     response_record?: RunnerResponseRecord;
+    /** Explicit logical wholesale view with separately retained actual pages. */
+    product_page_collection?: ProductPageCollectionRecord;
     /** Which extraction path produced the parsed response (required per contract). */
     extraction: RunnerExtractionRecord;
     /**
@@ -2744,6 +2756,23 @@ export interface StoryboardStepResult {
      */
     hints?: StoryboardStepHint[];
 }
+/** One physical exchange within an opted-in logical wholesale read. */
+export interface ProductPageRecord {
+    page_index: number;
+    restart_count: number;
+    request: RunnerRequestRecord;
+    response: RunnerResponseRecord | null;
+    extraction: RunnerExtractionRecord;
+    schema_validated: boolean;
+}
+export interface ProductPageCollectionRecord {
+    complete: boolean;
+    page_count: number;
+    restart_count: number;
+    pages: ProductPageRecord[];
+    /** Runner-derived view used only for authored checks and context capture. */
+    logical_response?: Record<string, unknown>;
+}
 /**
  * Provenance entry for a context key: which step wrote it and how.
  * Populated by the runner as it applies `context_outputs` and convention-

package/dist/lib/testing/storyboard/types.d.ts

@@ -88,6 +88,8 @@ export interface Storyboard {
      *     staging fixture). The runner does not verify the assertion;
      *     scenarios that need state still fail naturally if the seed is
      *     not actually present.
+     *   - `collect_product_pages_runner` — intrinsic support for explicit wholesale
+     *     all-page steps; unavailable on older runners that ignore this metadata.
      *   - `real_wire` — always available. Tag scenarios that observe
      *     production behavior with this when you want them excluded from
      *     a future `--mock-only` mode; today the tag is a no-op gate.
@@ -797,6 +799,14 @@ export interface StoryboardStep {
      * fields from the same seller response without changing the request wire.
      */
     response_projection?: 'raw';
+    /**
+     * Follow every wholesale product page before authored checks and captures.
+     * Requires `collect_product_pages_runner` in the storyboard's `requires`.
+     * Reads must omit idempotency_key; each page/restart is a fresh request.
+     * Every page retains its own exchange and is schema/invariant checked; the
+     * combined logical view is explicitly separate from the wire response.
+     */
+    collect_product_pages?: true;
     /** Whether this step depends on state from a previous step */
     stateful?: boolean;
     /**
@@ -2391,7 +2401,7 @@ export interface RunnerSelectionResult {
  *
  * Spec: adcp-client#1626, adcp-client#2281, adcp-client#2356.
  */
-export type RequirementName = 'controller' | 'seeded_state' | 'real_wire' | 'webhook_receiver' | 'webhook_replay_receiver' | 'trusted_match_context_router_runner' | 'trusted_match_publisher_auth_runner' | 'property_list_reference_runner' | 'request_signer' | 'multi_agent';
+export type RequirementName = 'controller' | 'collect_product_pages_runner' | 'seeded_state' | 'real_wire' | 'webhook_receiver' | 'webhook_replay_receiver' | 'trusted_match_context_router_runner' | 'trusted_match_publisher_auth_runner' | 'property_list_reference_runner' | 'request_signer' | 'multi_agent';
 /**
  * Enumeration of every requirement this SDK knows how to satisfy. The loader
  * accepts other non-empty strings for forward compatibility; the runner treats
@@ -2728,6 +2738,8 @@ export interface StoryboardStepResult {
     request?: RunnerRequestRecord;
     /** Exact response observed, including transport, status, headers. */
     response_record?: RunnerResponseRecord;
+    /** Explicit logical wholesale view with separately retained actual pages. */
+    product_page_collection?: ProductPageCollectionRecord;
     /** Which extraction path produced the parsed response (required per contract). */
     extraction: RunnerExtractionRecord;
     /**
@@ -2744,6 +2756,23 @@ export interface StoryboardStepResult {
      */
     hints?: StoryboardStepHint[];
 }
+/** One physical exchange within an opted-in logical wholesale read. */
+export interface ProductPageRecord {
+    page_index: number;
+    restart_count: number;
+    request: RunnerRequestRecord;
+    response: RunnerResponseRecord | null;
+    extraction: RunnerExtractionRecord;
+    schema_validated: boolean;
+}
+export interface ProductPageCollectionRecord {
+    complete: boolean;
+    page_count: number;
+    restart_count: number;
+    pages: ProductPageRecord[];
+    /** Runner-derived view used only for authored checks and context capture. */
+    logical_response?: Record<string, unknown>;
+}
 /**
  * Provenance entry for a context key: which step wrote it and how.
  * Populated by the runner as it applies `context_outputs` and convention-

package/dist/lib/testing/storyboard/types.js

@@ -62,6 +62,7 @@ const DETAILED_SKIP_TO_CANONICAL = {
 };
 const KNOWN_REQUIREMENTS = /* @__PURE__ */ new Set([
   "controller",
+  "collect_product_pages_runner",
   "seeded_state",
   "real_wire",
   "webhook_receiver",

package/dist/lib/testing/storyboard/types.mjs

@@ -36,6 +36,7 @@ const DETAILED_SKIP_TO_CANONICAL = {
 };
 const KNOWN_REQUIREMENTS = /* @__PURE__ */ new Set([
   "controller",
+  "collect_product_pages_runner",
   "seeded_state",
   "real_wire",
   "webhook_receiver",

package/dist/lib/testing/storyboard/validations.d.mts

@@ -197,7 +197,7 @@ export interface UpstreamTrafficQueryResult {
  */
 export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
 /** Capability semver emitted in run summaries and used for advisory expiry. */
-export declare const RUNNER_CAPABILITY_VERSION = "17.0.0-beta.5";
+export declare const RUNNER_CAPABILITY_VERSION = "17.0.0-beta.7";
 /** True when a failed validation contributes to the owning step's grade. */
 export declare function validationFailsStep(result: ValidationResult): boolean;
 /**

package/dist/lib/testing/storyboard/validations.d.ts

@@ -197,7 +197,7 @@ export interface UpstreamTrafficQueryResult {
  */
 export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
 /** Capability semver emitted in run summaries and used for advisory expiry. */
-export declare const RUNNER_CAPABILITY_VERSION = "17.0.0-beta.5";
+export declare const RUNNER_CAPABILITY_VERSION = "17.0.0-beta.7";
 /** True when a failed validation contributes to the owning step's grade. */
 export declare function validationFailsStep(result: ValidationResult): boolean;
 /**

package/dist/lib/utils/envelope-status-compat.d.mts

@@ -44,8 +44,27 @@ export interface LegacyEnvelopeStatusOptions {
      */
     adcpVersion?: string;
 }
-/** 3.2 synchronous response arms that intentionally forbid task-envelope status. */
-export declare const STATUS_FREE_SYNC_RESPONSE_TOOLS: ReadonlySet<string>;
+/**
+ * Compact synchronous responses that the 3.0 shim must never give a `status`.
+ *
+ * 3.0 emitters never served these tools. On 3.2.x the schema forbids `status`;
+ * from the release that composes `core/protocol-envelope.json` into every task
+ * response it is REQUIRED, and a missing one is the seller's defect, not
+ * something to fill in. `list_collections` and `list_proposals` are 3.3-only.
+ */
+export declare const COMPACT_SYNC_RESPONSE_TOOLS: ReadonlySet<string>;
+/**
+ * True when the served release's published schema for `toolName` has no
+ * `status`, so a seller serving that release must not emit it: 3.2.x
+ * `list_products` / `decline_proposals`. False for every other tool, and for a
+ * release whose schema composes the protocol envelope (3.3 and the 3.2.x
+ * backport), where `status` is required and preserved.
+ *
+ * The release's own schema decides, not a version number, so a bundle that
+ * adds the envelope later changes the answer without a code change. An unknown
+ * version or a release with no such schema keeps `status`.
+ */
+export declare function omitsEnvelopeStatusForRelease(toolName: string, servedVersion: string | undefined): boolean;
 /**
  * Detect whether a response payload should be treated as 3.0.x for the
  * purposes of envelope-status leniency.

package/dist/lib/utils/envelope-status-compat.d.ts

@@ -44,8 +44,27 @@ export interface LegacyEnvelopeStatusOptions {
      */
     adcpVersion?: string;
 }
-/** 3.2 synchronous response arms that intentionally forbid task-envelope status. */
-export declare const STATUS_FREE_SYNC_RESPONSE_TOOLS: ReadonlySet<string>;
+/**
+ * Compact synchronous responses that the 3.0 shim must never give a `status`.
+ *
+ * 3.0 emitters never served these tools. On 3.2.x the schema forbids `status`;
+ * from the release that composes `core/protocol-envelope.json` into every task
+ * response it is REQUIRED, and a missing one is the seller's defect, not
+ * something to fill in. `list_collections` and `list_proposals` are 3.3-only.
+ */
+export declare const COMPACT_SYNC_RESPONSE_TOOLS: ReadonlySet<string>;
+/**
+ * True when the served release's published schema for `toolName` has no
+ * `status`, so a seller serving that release must not emit it: 3.2.x
+ * `list_products` / `decline_proposals`. False for every other tool, and for a
+ * release whose schema composes the protocol envelope (3.3 and the 3.2.x
+ * backport), where `status` is required and preserved.
+ *
+ * The release's own schema decides, not a version number, so a bundle that
+ * adds the envelope later changes the answer without a code change. An unknown
+ * version or a release with no such schema keeps `status`.
+ */
+export declare function omitsEnvelopeStatusForRelease(toolName: string, servedVersion: string | undefined): boolean;
 /**
  * Detect whether a response payload should be treated as 3.0.x for the
  * purposes of envelope-status leniency.