@adcp/sdk 17.0.0-beta.1 → 17.0.0-beta.3

package/dist/lib/testing/index.js

@@ -67,6 +67,7 @@ __export(testing_exports, {
   comply: () => import_compliance.comply,
   createComplyController: () => import_comply_controller.createComplyController,
   createSeedFixtureCache: () => import_test_controller.createSeedFixtureCache,
+  createStoryboardWebBotAuthFetch: () => import_web_bot_auth.createStoryboardWebBotAuthFetch,
   createTestAgent: () => import_test_helpers.createTestAgent,
   createTestClient: () => import_agent_tester.createTestClient,
   creativeAgent: () => import_test_helpers.creativeAgent,
@@ -234,6 +235,7 @@ var import_validation = require('../validation/index.js');
 var import_storyboard = require('./storyboard/index.js');
 var import_storyboard2 = require('./storyboard/index.js');
 var import_storyboard3 = require('./storyboard/index.js');
+var import_web_bot_auth = require('./storyboard/web-bot-auth.js');
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AdagentsJsonSchema,
@@ -285,6 +287,7 @@ var import_storyboard3 = require('./storyboard/index.js');
   comply,
   createComplyController,
   createSeedFixtureCache,
+  createStoryboardWebBotAuthFetch,
   createTestAgent,
   createTestClient,
   creativeAgent,

package/dist/lib/testing/index.mjs

@@ -212,6 +212,7 @@ import {
   withPreparedFixtures
 } from "./storyboard/index.mjs";
 import { resolveCreativeBuildProbe, validateCreativeBuildProbeSpec } from "./storyboard/index.mjs";
+import { createStoryboardWebBotAuthFetch } from "./storyboard/web-bot-auth.mjs";
 export {
   AdagentsJsonSchema,
   BrandJsonSchema,
@@ -262,6 +263,7 @@ export {
   comply,
   createComplyController,
   createSeedFixtureCache,
+  createStoryboardWebBotAuthFetch,
   createTestAgent,
   createTestClient,
   creativeAgent,

package/dist/lib/testing/storyboard/canonical-format-satisfaction.js

@@ -47,13 +47,6 @@ const HANDLED_CANONICAL_PARAM_KEYS = /* @__PURE__ */ new Set([
   "duration_ms_range"
 ]);
 const ARRAY_SUBSET_PARAM_KEYS = /* @__PURE__ */ new Set(["video_codecs", "audio_codecs", "mime_types", "file_types", "formats"]);
-const OMITTABLE_DECLARATION_PARAMS = /* @__PURE__ */ new Set([
-  "asset_source",
-  "buyer_asset_acceptance",
-  "composition_model",
-  "slots",
-  "ssl_required"
-]);
 function validateCanonicalFormatSatisfaction(validation, request, context, taskResult) {
   if (typeof validation.value !== "boolean") {
     return {
@@ -208,17 +201,41 @@ function evaluatePackage(pkg, pointer, index, products) {
       actual: productId ?? null
     };
   }
+  const routes = [];
   const formatOptionRefs = Array.isArray(pkg.format_option_refs) ? pkg.format_option_refs : [];
   if (formatOptionRefs.length > 0) {
-    return evaluateFormatOptionRefs(formatOptionRefs, product, pointer);
+    routes.push({ name: "format_option_refs", verdict: evaluateFormatOptionRefs(formatOptionRefs, product, pointer) });
   }
   const formatIds = Array.isArray(pkg.format_ids) ? pkg.format_ids : [];
   if (formatIds.length > 0) {
-    return evaluateLegacyFormatIds(formatIds, product, pointer, productId);
+    routes.push({ name: "format_ids", verdict: evaluateLegacyFormatIds(formatIds, product, pointer, productId) });
   }
   const canonicalSelectors = extractCanonicalSelectors(pkg, pointer);
   if (canonicalSelectors.length > 0) {
-    return evaluateCanonicalSelectors(canonicalSelectors, product);
+    routes.push({ name: "canonical selectors", verdict: evaluateCanonicalSelectors(canonicalSelectors, product) });
+  }
+  const failed = routes.find((route) => !route.verdict.satisfied);
+  if (failed) return failed.verdict;
+  const primary = routes[0];
+  if (primary) {
+    const selected = new Set(primary.verdict.selectedDeclarations);
+    const conflicting = routes.slice(1).find((route) => {
+      const other = new Set(route.verdict.selectedDeclarations);
+      return selected.size !== other.size || [...selected].some((index2) => !other.has(index2));
+    });
+    if (conflicting) {
+      return {
+        satisfied: false,
+        bug_class: "directionality",
+        detail: `Conflicting selector routes ${primary.name} and ${conflicting.name} select different product format_options[] sets`,
+        json_pointer: pointer,
+        observations: routes.map((route) => ({
+          route: route.name,
+          selected_declarations: route.verdict.selectedDeclarations
+        }))
+      };
+    }
+    return primary.verdict;
   }
   return {
     satisfied: true,
@@ -238,6 +255,7 @@ function evaluateFormatOptionRefs(refs, product, packagePointer) {
       actual: refs
     };
   }
+  const selected = /* @__PURE__ */ new Set();
   for (let i = 0; i < refs.length; i++) {
     const ref = refs[i];
     if (!isRecord(ref)) {
@@ -267,13 +285,13 @@ function evaluateFormatOptionRefs(refs, product, packagePointer) {
         actual: ref
       };
     }
-    const match = declarations.find((decl) => {
+    const match = declarations.findIndex((decl) => {
       if (ref.scope === "publisher") {
         return decl.publisher_domain === ref.publisher_domain && decl.format_option_id === ref.format_option_id && typeof ref.publisher_domain === "string";
       }
       return decl.format_option_id === ref.format_option_id && !decl.publisher_domain;
     });
-    if (!match) {
+    if (match < 0) {
       return {
         satisfied: false,
         bug_class: "closed_set",
@@ -283,16 +301,19 @@ function evaluateFormatOptionRefs(refs, product, packagePointer) {
         observations: [{ available_format_option_ids: declarations.map(declarationLabel).filter(Boolean) }]
       };
     }
+    selected.add(match);
   }
   return {
     satisfied: true,
     bug_class: "directionality",
     detail: "Every format_option_refs[] entry resolved to the target product format_options[] closed set",
-    json_pointer: `${packagePointer}/format_option_refs`
+    json_pointer: `${packagePointer}/format_option_refs`,
+    selectedDeclarations: [...selected]
   };
 }
 function evaluateLegacyFormatIds(refs, product, packagePointer, productId) {
   const declarations = productFormatOptions(product);
+  const selected = /* @__PURE__ */ new Set();
   for (let i = 0; i < refs.length; i++) {
     const ref = refs[i];
     if (!isFormatId(ref)) {
@@ -304,12 +325,22 @@ function evaluateLegacyFormatIds(refs, product, packagePointer, productId) {
         actual: ref
       };
     }
-    const direct = declarations.find((decl) => (decl.v1_format_ref ?? []).some((v1) => sameFormatId(v1, ref)));
-    if (direct) continue;
+    const direct = declarations.flatMap(
+      (decl, index) => (decl.v1_format_ref ?? []).some((v1) => sameFormatId(v1, ref)) ? [index] : []
+    );
+    if (direct.length > 0) {
+      for (const index of direct) selected.add(index);
+      continue;
+    }
     const projected = projectLegacyRef(ref, productId, `${packagePointer}/format_ids/${i}`);
     if (projected) {
-      const match = declarations.find((decl) => canonicalSelectorSatisfiesDeclaration(projected, decl).ok);
-      if (match) continue;
+      const matches = declarations.flatMap(
+        (decl, index) => canonicalSelectorSatisfiesDeclaration(projected, decl).ok ? [index] : []
+      );
+      if (matches.length > 0) {
+        for (const index of matches) selected.add(index);
+        continue;
+      }
     }
     if (declarations.length === 0 && Array.isArray(product.format_ids) && product.format_ids.some((fid) => isFormatId(fid) && sameFormatId(fid, ref))) {
       continue;
@@ -327,7 +358,8 @@ function evaluateLegacyFormatIds(refs, product, packagePointer, productId) {
     satisfied: true,
     bug_class: "normalization",
     detail: "Every legacy format_id normalized to a product canonical declaration or product legacy format_id",
-    json_pointer: `${packagePointer}/format_ids`
+    json_pointer: `${packagePointer}/format_ids`,
+    selectedDeclarations: [...selected]
   };
 }
 function evaluateCanonicalSelectors(selectors, product) {
@@ -341,6 +373,7 @@ function evaluateCanonicalSelectors(selectors, product) {
       actual: selectors
     };
   }
+  const selected = /* @__PURE__ */ new Set();
   for (const selector of selectors) {
     const candidates = declarations.filter((decl) => decl.format_kind === selector.format_kind);
     if (candidates.length === 0) {
@@ -353,7 +386,12 @@ function evaluateCanonicalSelectors(selectors, product) {
       };
     }
     const checks = candidates.map((decl) => canonicalSelectorSatisfiesDeclaration(selector, decl));
-    if (checks.some((c) => c.ok)) continue;
+    if (checks.some((c) => c.ok)) {
+      for (const [index, decl] of declarations.entries()) {
+        if (canonicalSelectorSatisfiesDeclaration(selector, decl).ok) selected.add(index);
+      }
+      continue;
+    }
     const primary = checks.find((c) => c.bug_class === "range_containment") ?? checks[0];
     return {
       satisfied: false,
@@ -368,7 +406,8 @@ function evaluateCanonicalSelectors(selectors, product) {
     satisfied: true,
     bug_class: "directionality",
     detail: "Every canonical selector satisfies at least one product format_options[] declaration",
-    json_pointer: selectors[0]?.pointer ?? null
+    json_pointer: selectors[0]?.pointer ?? null,
+    selectedDeclarations: [...selected]
   };
 }
 function canonicalSelectorSatisfiesDeclaration(selector, decl) {
@@ -438,14 +477,7 @@ function requireRemainingParamContainment(productParams, requestParams) {
   for (const [key, productValue] of Object.entries(productParams)) {
     if (HANDLED_CANONICAL_PARAM_KEYS.has(key) || productValue === void 0) continue;
     if (Array.isArray(productValue) && productValue.length === 0) continue;
-    if (requestParams[key] === void 0) {
-      if (OMITTABLE_DECLARATION_PARAMS.has(key)) continue;
-      return {
-        ok: false,
-        bug_class: "directionality",
-        detail: `Under-specified selector: product constrains params.${key}, but the request selector omits ${key}`
-      };
-    }
+    if (requestParams[key] === void 0) continue;
     const requestValue = requestParams[key];
     if (ARRAY_SUBSET_PARAM_KEYS.has(key)) {
       const subset = requireArraySubset(key, productValue, requestValue);
@@ -737,7 +769,7 @@ function collectRejectionInfo(value, codes, fields, messages, depth = 0) {
 }
 function rejectionSupportsFormatFailure(rejection) {
   if (!rejection) return false;
-  if (rejection.codes.some((code) => code.startsWith("FORMAT_"))) return true;
+  if (rejection.codes.some((code) => code.startsWith("FORMAT_") || code === "CONFLICTING_SELECTORS")) return true;
   return [...rejection.fields, ...rejection.messages].some(
     (text) => /format|format_option|format_id|selector/i.test(text)
   );

package/dist/lib/testing/storyboard/canonical-format-satisfaction.mjs

@@ -23,13 +23,6 @@ const HANDLED_CANONICAL_PARAM_KEYS = /* @__PURE__ */ new Set([
   "duration_ms_range"
 ]);
 const ARRAY_SUBSET_PARAM_KEYS = /* @__PURE__ */ new Set(["video_codecs", "audio_codecs", "mime_types", "file_types", "formats"]);
-const OMITTABLE_DECLARATION_PARAMS = /* @__PURE__ */ new Set([
-  "asset_source",
-  "buyer_asset_acceptance",
-  "composition_model",
-  "slots",
-  "ssl_required"
-]);
 function validateCanonicalFormatSatisfaction(validation, request, context, taskResult) {
   if (typeof validation.value !== "boolean") {
     return {
@@ -184,17 +177,41 @@ function evaluatePackage(pkg, pointer, index, products) {
       actual: productId ?? null
     };
   }
+  const routes = [];
   const formatOptionRefs = Array.isArray(pkg.format_option_refs) ? pkg.format_option_refs : [];
   if (formatOptionRefs.length > 0) {
-    return evaluateFormatOptionRefs(formatOptionRefs, product, pointer);
+    routes.push({ name: "format_option_refs", verdict: evaluateFormatOptionRefs(formatOptionRefs, product, pointer) });
   }
   const formatIds = Array.isArray(pkg.format_ids) ? pkg.format_ids : [];
   if (formatIds.length > 0) {
-    return evaluateLegacyFormatIds(formatIds, product, pointer, productId);
+    routes.push({ name: "format_ids", verdict: evaluateLegacyFormatIds(formatIds, product, pointer, productId) });
   }
   const canonicalSelectors = extractCanonicalSelectors(pkg, pointer);
   if (canonicalSelectors.length > 0) {
-    return evaluateCanonicalSelectors(canonicalSelectors, product);
+    routes.push({ name: "canonical selectors", verdict: evaluateCanonicalSelectors(canonicalSelectors, product) });
+  }
+  const failed = routes.find((route) => !route.verdict.satisfied);
+  if (failed) return failed.verdict;
+  const primary = routes[0];
+  if (primary) {
+    const selected = new Set(primary.verdict.selectedDeclarations);
+    const conflicting = routes.slice(1).find((route) => {
+      const other = new Set(route.verdict.selectedDeclarations);
+      return selected.size !== other.size || [...selected].some((index2) => !other.has(index2));
+    });
+    if (conflicting) {
+      return {
+        satisfied: false,
+        bug_class: "directionality",
+        detail: `Conflicting selector routes ${primary.name} and ${conflicting.name} select different product format_options[] sets`,
+        json_pointer: pointer,
+        observations: routes.map((route) => ({
+          route: route.name,
+          selected_declarations: route.verdict.selectedDeclarations
+        }))
+      };
+    }
+    return primary.verdict;
   }
   return {
     satisfied: true,
@@ -214,6 +231,7 @@ function evaluateFormatOptionRefs(refs, product, packagePointer) {
       actual: refs
     };
   }
+  const selected = /* @__PURE__ */ new Set();
   for (let i = 0; i < refs.length; i++) {
     const ref = refs[i];
     if (!isRecord(ref)) {
@@ -243,13 +261,13 @@ function evaluateFormatOptionRefs(refs, product, packagePointer) {
         actual: ref
       };
     }
-    const match = declarations.find((decl) => {
+    const match = declarations.findIndex((decl) => {
       if (ref.scope === "publisher") {
         return decl.publisher_domain === ref.publisher_domain && decl.format_option_id === ref.format_option_id && typeof ref.publisher_domain === "string";
       }
       return decl.format_option_id === ref.format_option_id && !decl.publisher_domain;
     });
-    if (!match) {
+    if (match < 0) {
       return {
         satisfied: false,
         bug_class: "closed_set",
@@ -259,16 +277,19 @@ function evaluateFormatOptionRefs(refs, product, packagePointer) {
         observations: [{ available_format_option_ids: declarations.map(declarationLabel).filter(Boolean) }]
       };
     }
+    selected.add(match);
   }
   return {
     satisfied: true,
     bug_class: "directionality",
     detail: "Every format_option_refs[] entry resolved to the target product format_options[] closed set",
-    json_pointer: `${packagePointer}/format_option_refs`
+    json_pointer: `${packagePointer}/format_option_refs`,
+    selectedDeclarations: [...selected]
   };
 }
 function evaluateLegacyFormatIds(refs, product, packagePointer, productId) {
   const declarations = productFormatOptions(product);
+  const selected = /* @__PURE__ */ new Set();
   for (let i = 0; i < refs.length; i++) {
     const ref = refs[i];
     if (!isFormatId(ref)) {
@@ -280,12 +301,22 @@ function evaluateLegacyFormatIds(refs, product, packagePointer, productId) {
         actual: ref
       };
     }
-    const direct = declarations.find((decl) => (decl.v1_format_ref ?? []).some((v1) => sameFormatId(v1, ref)));
-    if (direct) continue;
+    const direct = declarations.flatMap(
+      (decl, index) => (decl.v1_format_ref ?? []).some((v1) => sameFormatId(v1, ref)) ? [index] : []
+    );
+    if (direct.length > 0) {
+      for (const index of direct) selected.add(index);
+      continue;
+    }
     const projected = projectLegacyRef(ref, productId, `${packagePointer}/format_ids/${i}`);
     if (projected) {
-      const match = declarations.find((decl) => canonicalSelectorSatisfiesDeclaration(projected, decl).ok);
-      if (match) continue;
+      const matches = declarations.flatMap(
+        (decl, index) => canonicalSelectorSatisfiesDeclaration(projected, decl).ok ? [index] : []
+      );
+      if (matches.length > 0) {
+        for (const index of matches) selected.add(index);
+        continue;
+      }
     }
     if (declarations.length === 0 && Array.isArray(product.format_ids) && product.format_ids.some((fid) => isFormatId(fid) && sameFormatId(fid, ref))) {
       continue;
@@ -303,7 +334,8 @@ function evaluateLegacyFormatIds(refs, product, packagePointer, productId) {
     satisfied: true,
     bug_class: "normalization",
     detail: "Every legacy format_id normalized to a product canonical declaration or product legacy format_id",
-    json_pointer: `${packagePointer}/format_ids`
+    json_pointer: `${packagePointer}/format_ids`,
+    selectedDeclarations: [...selected]
   };
 }
 function evaluateCanonicalSelectors(selectors, product) {
@@ -317,6 +349,7 @@ function evaluateCanonicalSelectors(selectors, product) {
       actual: selectors
     };
   }
+  const selected = /* @__PURE__ */ new Set();
   for (const selector of selectors) {
     const candidates = declarations.filter((decl) => decl.format_kind === selector.format_kind);
     if (candidates.length === 0) {
@@ -329,7 +362,12 @@ function evaluateCanonicalSelectors(selectors, product) {
       };
     }
     const checks = candidates.map((decl) => canonicalSelectorSatisfiesDeclaration(selector, decl));
-    if (checks.some((c) => c.ok)) continue;
+    if (checks.some((c) => c.ok)) {
+      for (const [index, decl] of declarations.entries()) {
+        if (canonicalSelectorSatisfiesDeclaration(selector, decl).ok) selected.add(index);
+      }
+      continue;
+    }
     const primary = checks.find((c) => c.bug_class === "range_containment") ?? checks[0];
     return {
       satisfied: false,
@@ -344,7 +382,8 @@ function evaluateCanonicalSelectors(selectors, product) {
     satisfied: true,
     bug_class: "directionality",
     detail: "Every canonical selector satisfies at least one product format_options[] declaration",
-    json_pointer: selectors[0]?.pointer ?? null
+    json_pointer: selectors[0]?.pointer ?? null,
+    selectedDeclarations: [...selected]
   };
 }
 function canonicalSelectorSatisfiesDeclaration(selector, decl) {
@@ -414,14 +453,7 @@ function requireRemainingParamContainment(productParams, requestParams) {
   for (const [key, productValue] of Object.entries(productParams)) {
     if (HANDLED_CANONICAL_PARAM_KEYS.has(key) || productValue === void 0) continue;
     if (Array.isArray(productValue) && productValue.length === 0) continue;
-    if (requestParams[key] === void 0) {
-      if (OMITTABLE_DECLARATION_PARAMS.has(key)) continue;
-      return {
-        ok: false,
-        bug_class: "directionality",
-        detail: `Under-specified selector: product constrains params.${key}, but the request selector omits ${key}`
-      };
-    }
+    if (requestParams[key] === void 0) continue;
     const requestValue = requestParams[key];
     if (ARRAY_SUBSET_PARAM_KEYS.has(key)) {
       const subset = requireArraySubset(key, productValue, requestValue);
@@ -713,7 +745,7 @@ function collectRejectionInfo(value, codes, fields, messages, depth = 0) {
 }
 function rejectionSupportsFormatFailure(rejection) {
   if (!rejection) return false;
-  if (rejection.codes.some((code) => code.startsWith("FORMAT_"))) return true;
+  if (rejection.codes.some((code) => code.startsWith("FORMAT_") || code === "CONFLICTING_SELECTORS")) return true;
   return [...rejection.fields, ...rejection.messages].some(
     (text) => /format|format_option|format_id|selector/i.test(text)
   );

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

@@ -181,12 +181,9 @@ export declare function getExternalSchemaRootForCompliance(options: ResolveOptio
 export declare function loadBundleStoryboards(ref: BundleRef): Storyboard[];
 /** Enumerate every bundle present in the cache (universal + protocols + specialisms). */
 export declare function listBundles(options?: ResolveOptions): BundleRef[];
-/** List every storyboard the cache can produce, across all bundles. */
+/** List every storyboard the selected immutable bundle can produce, as detached records. */
 export declare function listAllComplianceStoryboards(options?: ResolveOptions): Storyboard[];
-/**
- * Find a storyboard by its internal `id` (the YAML's `id:` field).
- * Scans every bundle in the cache. Returns undefined if no match.
- */
+/** Find a storyboard by its internal YAML id without reparsing a warm bundle. */
 export declare function getComplianceStoryboardById(id: string, options?: ResolveOptions): Storyboard | undefined;
 /** Find a bundle by its directory/file id (`media-buy`, `sales-guaranteed`, `capability-discovery`). */
 export declare function findBundleById(id: string, options?: ResolveOptions): BundleRef | undefined;

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

@@ -181,12 +181,9 @@ export declare function getExternalSchemaRootForCompliance(options: ResolveOptio
 export declare function loadBundleStoryboards(ref: BundleRef): Storyboard[];
 /** Enumerate every bundle present in the cache (universal + protocols + specialisms). */
 export declare function listBundles(options?: ResolveOptions): BundleRef[];
-/** List every storyboard the cache can produce, across all bundles. */
+/** List every storyboard the selected immutable bundle can produce, as detached records. */
 export declare function listAllComplianceStoryboards(options?: ResolveOptions): Storyboard[];
-/**
- * Find a storyboard by its internal `id` (the YAML's `id:` field).
- * Scans every bundle in the cache. Returns undefined if no match.
- */
+/** Find a storyboard by its internal YAML id without reparsing a warm bundle. */
 export declare function getComplianceStoryboardById(id: string, options?: ResolveOptions): Storyboard | undefined;
 /** Find a bundle by its directory/file id (`media-buy`, `sales-guaranteed`, `capability-discovery`). */
 export declare function findBundleById(id: string, options?: ResolveOptions): BundleRef | undefined;

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

@@ -47,6 +47,7 @@ var import_errors = require('../../errors/index.js');
 var import_adcp_version_config = require('../../utils/adcp-version-config.js');
 var import_schema_loader = require('../../validation/schema-loader.js');
 var import_synthesize = require('./request-signing/synthesize.js');
+var import_vector_loader = require('./request-signing/vector-loader.js');
 var import_provenance = require('./provenance.js');
 class CapabilityResolutionError extends import_errors.ADCPError {
   code;
@@ -434,23 +435,71 @@ function listBundles(options = {}) {
   }
   return bundles;
 }
-function listAllComplianceStoryboards(options = {}) {
-  const seen = /* @__PURE__ */ new Set();
-  const storyboards = [];
-  for (const ref of listBundles(options)) {
-    for (const sb of loadBundleStoryboards(ref)) {
-      if (seen.has(sb.id)) continue;
-      seen.add(sb.id);
-      storyboards.push(sb);
+const STORYBOARD_INDEX_CACHE_LIMIT = 8;
+const storyboardIndexes = /* @__PURE__ */ new Map();
+function customComplianceInventory(dir) {
+  if (!(0, import_fs.existsSync)(dir)) return "missing";
+  const entries = [];
+  const visitedDirectories = /* @__PURE__ */ new Set();
+  const visit = (file, relative) => {
+    const stat = (0, import_fs.statSync)(file, { bigint: true });
+    entries.push([relative, String(stat.mtimeNs), String(stat.ctimeNs), String(stat.size), String(stat.ino)]);
+    if (!stat.isDirectory()) return;
+    const identity = `${stat.dev}:${stat.ino}`;
+    if (visitedDirectories.has(identity)) return;
+    visitedDirectories.add(identity);
+    for (const child of (0, import_fs.readdirSync)(file).sort()) visit((0, import_path.join)(file, child), `${relative}/${child}`);
+  };
+  visit(dir, "");
+  return JSON.stringify(entries);
+}
+function complianceStoryboardIndex(options) {
+  const dir = (0, import_path.resolve)(getComplianceCacheDir(options));
+  const indexPath = (0, import_path.join)(dir, "index.json");
+  const stamp = (0, import_fs.existsSync)(indexPath) ? (0, import_fs.statSync)(indexPath) : void 0;
+  const schemaRoot = getConfiguredSchemaRoot(options);
+  const customRoot = Boolean(getConfiguredComplianceDir(options));
+  const inventory = customRoot ? customComplianceInventory(dir) : null;
+  const key = JSON.stringify([
+    dir,
+    options.version ?? import_version.ADCP_VERSION,
+    schemaRoot ? (0, import_path.resolve)(schemaRoot) : null,
+    options.hostedStableLineAlias ?? null,
+    stamp?.mtimeMs ?? null,
+    stamp?.size ?? null,
+    inventory
+  ]);
+  const cached = storyboardIndexes.get(key);
+  if (cached) {
+    storyboardIndexes.delete(key);
+    storyboardIndexes.set(key, cached);
+    return cached;
+  }
+  if (customRoot) (0, import_vector_loader.invalidateRequestSigningVectorCache)(dir);
+  const indexed = /* @__PURE__ */ new Map();
+  for (const ref of listBundles({ ...options, complianceDir: dir })) {
+    for (const storyboard of loadBundleStoryboards(ref)) {
+      if (!indexed.has(storyboard.id)) indexed.set(storyboard.id, storyboard);
     }
   }
-  return storyboards;
+  storyboardIndexes.set(key, indexed);
+  while (storyboardIndexes.size > STORYBOARD_INDEX_CACHE_LIMIT) {
+    const oldest = storyboardIndexes.keys().next().value;
+    if (oldest !== void 0) storyboardIndexes.delete(oldest);
+  }
+  return indexed;
+}
+function cloneComplianceStoryboard(storyboard) {
+  const copy = structuredClone(storyboard);
+  const trustedRoot = (0, import_provenance.trustedStoryboardComplianceRoot)(storyboard);
+  return trustedRoot ? (0, import_provenance.markStoryboardComplianceRoot)(copy, trustedRoot) : copy;
+}
+function listAllComplianceStoryboards(options = {}) {
+  return [...complianceStoryboardIndex(options).values()].map(cloneComplianceStoryboard);
 }
 function getComplianceStoryboardById(id, options = {}) {
-  for (const sb of listAllComplianceStoryboards(options)) {
-    if (sb.id === id) return sb;
-  }
-  return void 0;
+  const storyboard = complianceStoryboardIndex(options).get(id);
+  return storyboard ? cloneComplianceStoryboard(storyboard) : void 0;
 }
 function findBundleById(id, options = {}) {
   return listBundles(options).find((b) => b.id === id);

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

@@ -12,7 +12,8 @@ import { ADCPError } from "../../errors/index.mjs";
 import { isAdcpVersionSupported } from "../../utils/adcp-version-config.mjs";
 import { hasSchemaBundle, resolveBundleKey } from "../../validation/schema-loader.mjs";
 import { synthesizeRequestSigningSteps } from "./request-signing/synthesize.mjs";
-import { markStoryboardComplianceRoot } from "./provenance.mjs";
+import { invalidateRequestSigningVectorCache } from "./request-signing/vector-loader.mjs";
+import { markStoryboardComplianceRoot, trustedStoryboardComplianceRoot } from "./provenance.mjs";
 class CapabilityResolutionError extends ADCPError {
   code;
   specialism;
@@ -399,23 +400,71 @@ function listBundles(options = {}) {
   }
   return bundles;
 }
-function listAllComplianceStoryboards(options = {}) {
-  const seen = /* @__PURE__ */ new Set();
-  const storyboards = [];
-  for (const ref of listBundles(options)) {
-    for (const sb of loadBundleStoryboards(ref)) {
-      if (seen.has(sb.id)) continue;
-      seen.add(sb.id);
-      storyboards.push(sb);
+const STORYBOARD_INDEX_CACHE_LIMIT = 8;
+const storyboardIndexes = /* @__PURE__ */ new Map();
+function customComplianceInventory(dir) {
+  if (!existsSync(dir)) return "missing";
+  const entries = [];
+  const visitedDirectories = /* @__PURE__ */ new Set();
+  const visit = (file, relative) => {
+    const stat = statSync(file, { bigint: true });
+    entries.push([relative, String(stat.mtimeNs), String(stat.ctimeNs), String(stat.size), String(stat.ino)]);
+    if (!stat.isDirectory()) return;
+    const identity = `${stat.dev}:${stat.ino}`;
+    if (visitedDirectories.has(identity)) return;
+    visitedDirectories.add(identity);
+    for (const child of readdirSync(file).sort()) visit(join(file, child), `${relative}/${child}`);
+  };
+  visit(dir, "");
+  return JSON.stringify(entries);
+}
+function complianceStoryboardIndex(options) {
+  const dir = resolve(getComplianceCacheDir(options));
+  const indexPath = join(dir, "index.json");
+  const stamp = existsSync(indexPath) ? statSync(indexPath) : void 0;
+  const schemaRoot = getConfiguredSchemaRoot(options);
+  const customRoot = Boolean(getConfiguredComplianceDir(options));
+  const inventory = customRoot ? customComplianceInventory(dir) : null;
+  const key = JSON.stringify([
+    dir,
+    options.version ?? ADCP_VERSION,
+    schemaRoot ? resolve(schemaRoot) : null,
+    options.hostedStableLineAlias ?? null,
+    stamp?.mtimeMs ?? null,
+    stamp?.size ?? null,
+    inventory
+  ]);
+  const cached = storyboardIndexes.get(key);
+  if (cached) {
+    storyboardIndexes.delete(key);
+    storyboardIndexes.set(key, cached);
+    return cached;
+  }
+  if (customRoot) invalidateRequestSigningVectorCache(dir);
+  const indexed = /* @__PURE__ */ new Map();
+  for (const ref of listBundles({ ...options, complianceDir: dir })) {
+    for (const storyboard of loadBundleStoryboards(ref)) {
+      if (!indexed.has(storyboard.id)) indexed.set(storyboard.id, storyboard);
     }
   }
-  return storyboards;
+  storyboardIndexes.set(key, indexed);
+  while (storyboardIndexes.size > STORYBOARD_INDEX_CACHE_LIMIT) {
+    const oldest = storyboardIndexes.keys().next().value;
+    if (oldest !== void 0) storyboardIndexes.delete(oldest);
+  }
+  return indexed;
+}
+function cloneComplianceStoryboard(storyboard) {
+  const copy = structuredClone(storyboard);
+  const trustedRoot = trustedStoryboardComplianceRoot(storyboard);
+  return trustedRoot ? markStoryboardComplianceRoot(copy, trustedRoot) : copy;
+}
+function listAllComplianceStoryboards(options = {}) {
+  return [...complianceStoryboardIndex(options).values()].map(cloneComplianceStoryboard);
 }
 function getComplianceStoryboardById(id, options = {}) {
-  for (const sb of listAllComplianceStoryboards(options)) {
-    if (sb.id === id) return sb;
-  }
-  return void 0;
+  const storyboard = complianceStoryboardIndex(options).get(id);
+  return storyboard ? cloneComplianceStoryboard(storyboard) : void 0;
 }
 function findBundleById(id, options = {}) {
   return listBundles(options).find((b) => b.id === id);

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

@@ -6,6 +6,7 @@
  * The canonical storyboard set lives in the AdCP compliance tarball
  * and is pulled into `compliance/cache/{version}/` via `npm run sync-schemas`.
  */
+export { createStoryboardWebBotAuthFetch } from './web-bot-auth.mjs';
 export type { A2ATaskEnvelope, AgentEntry, Storyboard, StoryboardFixtureResolution, FixtureResolutionStrategy, FixtureMatchOperator, FixtureMatchClause, FixtureResolutionDeclaration, ProductFixtureResolutionDeclaration, PricingOptionFixtureResolutionDeclaration, FixtureResolutionStatus, FixtureResolutionRecord, FixtureResolutionAttempt, FixtureResolutionEvidence, FixtureResolutionCoverageGap, StoryboardInvariants, StoryboardInvariantsObject, StepInvariantsObject, StoryboardPhase, StoryboardStep, RateLimitTripSpec, StoryboardValidation, StoryboardValidationCheck, WebhookFilterSpec, WebhookRetryTriggerSpec, WebhookAssertionErrorCode, ContextOutput, ContextInput, ContextProvenanceEntry, ContextValueRejectedHint, ShapeDriftHint, MissingRequiredFieldHint, FormatMismatchHint, MonotonicViolationHint, ImpairmentCoherenceHint, ImpairmentCoherenceNotApplicableHint, StoryboardContext, StoryboardRunOptions, PrepareStoryboardFixturesOptions, TrustedMatchContextProviderEndpoint, TrustedMatchContextRegistrationContext, TrustedMatchContextRouterRunnerOptions, TrustedMatchPublisherAuthOperation, TrustedMatchPublisherCredentialState, TrustedMatchPublisherAuthTls, TrustedMatchPublisherAuthProbeConfiguration, TrustedMatchPublisherAuthRunner, ValidationResult, StoryboardStepPreview, StoryboardStepResult, StoryboardStepHint, StoryboardStepHintBase, StoryboardPhaseResult, StoryboardResult, AssertionResult, StrictValidationSummary, StrictValidationVerdict, UpstreamTrafficPayloadMatch, RunnerNotice, NoticeCode, NoticeSeverity, } from './types.mjs';
 export { WEBHOOK_IDEMPOTENCY_KEY_PATTERN } from './types.mjs';
 export { MCP_SESSION_PROBE_TASK } from './types.mjs';