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

package/dist/lib/server/media-buy-store.mjs

@@ -1,6 +1,25 @@
 import { applyTargetingInput, resolveTargetingInput } from "../media-buy/targeting-input.mjs";
 import { scopedStore } from "./state-store.mjs";
 const DEFAULT_MEDIA_BUY_STORE_COLLECTION = "media_buys_targeting";
+const PACKAGE_IDENTITY_FIELDS = ["package_id", "product_id", "buyer_ref"];
+function compatibleIdentity(left, right) {
+  if (!left || !right) return false;
+  return PACKAGE_IDENTITY_FIELDS.every((key) => !left[key] || !right[key] || left[key] === right[key]);
+}
+function sharesIdentity(left, right) {
+  if (!left || !right) return false;
+  return compatibleIdentity(left, right) && PACKAGE_IDENTITY_FIELDS.some((key) => left[key] && left[key] === right[key]);
+}
+function matchContextPackage(requests, responses, index) {
+  const matches = requests.filter((request) => sharesIdentity(request, responses[index]));
+  if (matches.length === 1 && responses.filter((response) => sharesIdentity(matches[0], response)).length === 1) {
+    return matches[0];
+  }
+  if (requests.length === responses.length && requests.every((request, i) => compatibleIdentity(request, responses[i]))) {
+    return requests[index];
+  }
+  return void 0;
+}
 function createMediaBuyStore(options) {
   const collection = options.collection ?? DEFAULT_MEDIA_BUY_STORE_COLLECTION;
   function viewFor(accountId) {
@@ -18,8 +37,9 @@ function createMediaBuyStore(options) {
     async persistFromCreate(accountId, request, result) {
       const requestPackages = request.packages ?? [];
       const responsePackages = result.packages ?? [];
-      if (requestPackages.length === 0 || !result.media_buy_id) return;
-      const persistedPackages = [];
+      if (!result.media_buy_id) return;
+      const prior = await loadRecord(accountId, result.media_buy_id);
+      const byId = new Map((prior?.packages ?? []).map((pkg) => [pkg.package_id, { ...pkg }]));
       for (let i = 0; i < requestPackages.length; i++) {
         const reqPkg = requestPackages[i];
         if (!reqPkg?.targeting_overlay) continue;
@@ -30,12 +50,26 @@ function createMediaBuyStore(options) {
         if (!packageId) continue;
         const persistedOverlay = respPkg?.targeting_overlay ?? resolveTargetingInput(reqPkg.targeting_overlay);
         if (!persistedOverlay) continue;
-        persistedPackages.push({ package_id: packageId, targeting_overlay: persistedOverlay });
+        byId.set(packageId, { ...byId.get(packageId), package_id: packageId, targeting_overlay: persistedOverlay });
       }
-      if (persistedPackages.length === 0) return;
+      for (const [index, response] of responsePackages.entries()) {
+        if (!response.package_id) continue;
+        const context2 = matchContextPackage(requestPackages, responsePackages, index)?.context ?? response.context;
+        const stored = byId.get(response.package_id);
+        if (context2 !== void 0 && stored?.context === void 0) {
+          byId.set(response.package_id, {
+            ...stored,
+            package_id: response.package_id,
+            context: structuredClone(context2)
+          });
+        }
+      }
+      const context = prior?.context ?? request.context ?? result.context;
+      if (byId.size === 0 && context === void 0) return;
       await writeRecord(accountId, {
         media_buy_id: result.media_buy_id,
-        packages: persistedPackages
+        ...context !== void 0 ? { context: structuredClone(context) } : {},
+        packages: Array.from(byId.values())
       });
     },
     async mergeFromUpdate(accountId, mediaBuyId, patch) {
@@ -43,42 +77,56 @@ function createMediaBuyStore(options) {
         media_buy_id: mediaBuyId,
         packages: []
       };
-      const byId = new Map(prior.packages.map((p) => [p.package_id, p.targeting_overlay]));
+      const byId = new Map(prior.packages.map((p) => [p.package_id, { ...p }]));
       for (const pkg of patch.packages ?? []) {
         const packageId = pkg?.package_id;
         if (!packageId) continue;
         if (!("targeting_overlay" in pkg)) continue;
         const incoming = pkg.targeting_overlay;
         if (incoming === void 0) continue;
-        const merged = applyTargetingInput(byId.get(packageId), incoming);
-        if (merged) byId.set(packageId, merged);
-        else byId.delete(packageId);
+        const stored = byId.get(packageId);
+        const merged = applyTargetingInput(stored?.targeting_overlay, incoming);
+        if (merged) byId.set(packageId, { ...stored, package_id: packageId, targeting_overlay: merged });
+        else if (stored?.context !== void 0) {
+          byId.set(packageId, { package_id: packageId, context: stored.context });
+        } else byId.delete(packageId);
       }
       for (const pkg of patch.new_packages ?? []) {
         if (!pkg?.targeting_overlay || !pkg.package_id) continue;
         const resolved = resolveTargetingInput(pkg.targeting_overlay);
-        if (resolved) byId.set(pkg.package_id, resolved);
+        if (resolved)
+          byId.set(pkg.package_id, {
+            ...byId.get(pkg.package_id),
+            package_id: pkg.package_id,
+            targeting_overlay: resolved
+          });
       }
       await writeRecord(accountId, {
-        media_buy_id: mediaBuyId,
-        packages: Array.from(byId.entries()).map(([package_id, targeting_overlay]) => ({
-          package_id,
-          targeting_overlay
-        }))
+        ...prior,
+        packages: Array.from(byId.values())
       });
     },
     async backfill(accountId, result) {
       const buys = result.media_buys;
       if (!buys || buys.length === 0) return result;
       for (const buy of buys) {
-        if (!buy?.media_buy_id || !buy.packages) continue;
+        if (!buy?.media_buy_id) continue;
         const record = await loadRecord(accountId, buy.media_buy_id);
         if (!record) continue;
-        const overlayById = new Map(record.packages.map((p) => [p.package_id, p.targeting_overlay]));
-        for (const pkg of buy.packages) {
-          if (!pkg?.package_id || pkg.targeting_overlay !== void 0) continue;
-          const persisted = overlayById.get(pkg.package_id);
-          if (persisted) pkg.targeting_overlay = persisted;
+        if (buy.context === void 0 && record.context !== void 0) {
+          buy.context = structuredClone(record.context);
+        }
+        const byId = new Map(record.packages.map((p) => [p.package_id, p]));
+        for (const pkg of buy.packages ?? []) {
+          if (!pkg?.package_id) continue;
+          const persisted = byId.get(pkg.package_id);
+          if (!persisted) continue;
+          if (pkg.targeting_overlay === void 0 && persisted.targeting_overlay !== void 0) {
+            pkg.targeting_overlay = persisted.targeting_overlay;
+          }
+          if (pkg.context === void 0 && persisted.context !== void 0) {
+            pkg.context = structuredClone(persisted.context);
+          }
         }
       }
       return result;

package/dist/lib/server/notification-subscriptions/runtime.d.mts

@@ -1,7 +1,7 @@
 import type { WebhookAttemptSuppressionReason } from '../webhook-emitter.mjs';
 import type { NotificationSubscriptionConfigInput, NotificationSubscriptionView, NotificationSuppressionDisposition, PersistentNotificationRuntime, PersistentNotificationRuntimeOptions, StoredNotificationSubscription } from './types.mjs';
 export declare const CALLER_NOTIFICATION_TYPES: readonly ["capabilities.changed", "principal.changed"];
-export declare const ACCOUNT_NOTIFICATION_TYPES: readonly ["creative.status_changed", "creative.assignment_changed", "indicators.changed", "creative.purged", "account.status_changed", "account.change_recorded", "product.created", "product.updated", "product.priced", "product.removed", "signal.created", "signal.updated", "signal.priced", "signal.removed", "wholesale_feed.bulk_change", "reporting.delivery_ready", "reporting.status_changed", "reporting.ledger_changed"];
+export declare const ACCOUNT_NOTIFICATION_TYPES: readonly ["creative.status_changed", "creative.assignment_changed", "indicators.changed", "creative.purged", "account.status_changed", "account.change_recorded", "product.created", "product.updated", "product.priced", "product.removed", "signal.created", "signal.updated", "signal.priced", "signal.removed", "wholesale_feed.bulk_change", "collection_card.updated", "collection_card.removed", "collection_catalog.bulk_change", "proposal.created", "reporting.delivery_ready", "reporting.status_changed", "reporting.ledger_changed"];
 /**
  * Durable subscription control plane. The supplied emitter factory is called
  * exactly once with the runtime's mandatory live authorizer, preventing a

package/dist/lib/server/notification-subscriptions/runtime.d.ts

@@ -1,7 +1,7 @@
 import type { WebhookAttemptSuppressionReason } from '../webhook-emitter';
 import type { NotificationSubscriptionConfigInput, NotificationSubscriptionView, NotificationSuppressionDisposition, PersistentNotificationRuntime, PersistentNotificationRuntimeOptions, StoredNotificationSubscription } from './types';
 export declare const CALLER_NOTIFICATION_TYPES: readonly ["capabilities.changed", "principal.changed"];
-export declare const ACCOUNT_NOTIFICATION_TYPES: readonly ["creative.status_changed", "creative.assignment_changed", "indicators.changed", "creative.purged", "account.status_changed", "account.change_recorded", "product.created", "product.updated", "product.priced", "product.removed", "signal.created", "signal.updated", "signal.priced", "signal.removed", "wholesale_feed.bulk_change", "reporting.delivery_ready", "reporting.status_changed", "reporting.ledger_changed"];
+export declare const ACCOUNT_NOTIFICATION_TYPES: readonly ["creative.status_changed", "creative.assignment_changed", "indicators.changed", "creative.purged", "account.status_changed", "account.change_recorded", "product.created", "product.updated", "product.priced", "product.removed", "signal.created", "signal.updated", "signal.priced", "signal.removed", "wholesale_feed.bulk_change", "collection_card.updated", "collection_card.removed", "collection_catalog.bulk_change", "proposal.created", "reporting.delivery_ready", "reporting.status_changed", "reporting.ledger_changed"];
 /**
  * Durable subscription control plane. The supplied emitter factory is called
  * exactly once with the runtime's mandatory live authorizer, preventing a

package/dist/lib/server/notification-subscriptions/runtime.js

@@ -51,6 +51,10 @@ const ACCOUNT_NOTIFICATION_TYPES = Object.freeze([
   "signal.priced",
   "signal.removed",
   "wholesale_feed.bulk_change",
+  "collection_card.updated",
+  "collection_card.removed",
+  "collection_catalog.bulk_change",
+  "proposal.created",
   "reporting.delivery_ready",
   "reporting.status_changed",
   "reporting.ledger_changed"

package/dist/lib/server/notification-subscriptions/runtime.mjs

@@ -22,6 +22,10 @@ const ACCOUNT_NOTIFICATION_TYPES = Object.freeze([
   "signal.priced",
   "signal.removed",
   "wholesale_feed.bulk_change",
+  "collection_card.updated",
+  "collection_card.removed",
+  "collection_catalog.bulk_change",
+  "proposal.created",
   "reporting.delivery_ready",
   "reporting.status_changed",
   "reporting.ledger_changed"

package/dist/lib/server/responses.js

@@ -60,6 +60,7 @@ __export(responses_exports, {
 module.exports = __toCommonJS(responses_exports);
 var import_media_buy_helpers = require('./media-buy-helpers.js');
 var import_reporting_delivery_config = require('./reporting-delivery-config.js');
+var import_account_response_identity = require('./account-response-identity.js');
 const explicitResponseSummaries = /* @__PURE__ */ new WeakMap();
 function _getExplicitResponseSummary(response) {
   return explicitResponseSummaries.get(response);
@@ -124,7 +125,14 @@ function stripBusinessEntityBank(row, key) {
   return stripped;
 }
 function stripAccountWriteOnlyFields(account) {
-  const stripped = stripBusinessEntityBank(stripNotificationConfigSecrets(account), "billing_entity");
+  const {
+    destination_billing_entity: _destination,
+    authInfo: _authInfo,
+    ctx_metadata: _metadata,
+    ...responseFields
+  } = account;
+  const response = stripBusinessEntityBank(stripNotificationConfigSecrets(responseFields), "billing_entity");
+  const stripped = { ...response, ...(0, import_account_response_identity.projectAccountResponseIdentityFields)(response) };
   const reportingDeliveryConfigs = stripped.reporting_delivery_configs;
   if (reportingDeliveryConfigs === void 0) return stripped;
   return {

package/dist/lib/server/responses.mjs

@@ -1,5 +1,6 @@
 import { validActionsForStatus } from "./media-buy-helpers.mjs";
 import { projectReportingDeliveryConfigStates } from "./reporting-delivery-config.mjs";
+import { projectAccountResponseIdentityFields } from "./account-response-identity.mjs";
 const explicitResponseSummaries = /* @__PURE__ */ new WeakMap();
 function _getExplicitResponseSummary(response) {
   return explicitResponseSummaries.get(response);
@@ -64,7 +65,14 @@ function stripBusinessEntityBank(row, key) {
   return stripped;
 }
 function stripAccountWriteOnlyFields(account) {
-  const stripped = stripBusinessEntityBank(stripNotificationConfigSecrets(account), "billing_entity");
+  const {
+    destination_billing_entity: _destination,
+    authInfo: _authInfo,
+    ctx_metadata: _metadata,
+    ...responseFields
+  } = account;
+  const response = stripBusinessEntityBank(stripNotificationConfigSecrets(responseFields), "billing_entity");
+  const stripped = { ...response, ...projectAccountResponseIdentityFields(response) };
   const reportingDeliveryConfigs = stripped.reporting_delivery_configs;
   if (reportingDeliveryConfigs === void 0) return stripped;
   return {

package/dist/lib/signing/agent-fetch.d.mts

@@ -80,7 +80,7 @@ export interface BuildAgentSigningFetchOptions {
  *   1. Sign immediately when the payload carries webhook authentication.
  *   2. Resolve the AdCP operation and exact JSON-RPC protocol method.
  *   3. Consult each capability namespace independently; either can request
- *      signing. Legacy SDK task polls sign when the seller supports signing.
+ *      signing. SDK AdCP task polls sign when the seller supports signing.
  *   4. Resolve the seller's content-digest policy into a per-request toggle.
  *   5. Delegate to `createSigningFetch` with the decision baked in.
  */

package/dist/lib/signing/agent-fetch.d.ts

@@ -80,7 +80,7 @@ export interface BuildAgentSigningFetchOptions {
  *   1. Sign immediately when the payload carries webhook authentication.
  *   2. Resolve the AdCP operation and exact JSON-RPC protocol method.
  *   3. Consult each capability namespace independently; either can request
- *      signing. Legacy SDK task polls sign when the seller supports signing.
+ *      signing. SDK AdCP task polls sign when the seller supports signing.
  *   4. Resolve the seller's content-digest policy into a per-request toggle.
  *   5. Delegate to `createSigningFetch` with the decision baked in.
  */

package/dist/lib/signing/agent-fetch.js

@@ -157,13 +157,13 @@ function buildAgentSigningFetch(options) {
     }
     const operation = extractAdcpOperation(init?.body);
     if (operation === "get_adcp_capabilities" && (0, import_protocol_methods.hasUnsignedCapabilityBootstrap)(signing)) return false;
-    const isPollOperation = operation === "tasks_get" || operation === "tasks/get";
+    const isPollOperation = operation === "get_task_status" || operation === "tasks_get" || operation === "tasks/get";
     const methods = policyMethods ?? (isPollOperation ? jsonRpcMethodsForSigning(init?.body) : []);
     const profileCompatible = signing.profile === "web-bot-auth" ? (0, import_protocol_methods.signingListIncludes)(capability?.profiles, "web-bot-auth") : capability?.profiles === void 0 || (0, import_protocol_methods.signingListIncludes)(capability.profiles, "adcp/request-signing/v1");
-    const legacyPoll = profileCompatible && capability?.supported === true && (operation === "tasks_get" && methods.includes("tools/call") || operation === "tasks/get" && methods.some(
+    const signedPoll = profileCompatible && capability?.supported === true && ((operation === "tasks_get" || operation === "get_task_status") && methods.includes("tools/call") || (operation === "tasks/get" || operation === "get_task_status") && methods.some(
       (method) => ["message/send", "message/stream", "SendMessage", "SendStreamingMessage"].includes(method)
     ));
-    const sign = signing.profile === "web-bot-auth" && !!operation && (0, import_protocol_methods.signingListIncludes)(capability?.profiles, "web-bot-auth") || shouldSignOperation(operation, capability, signing) || methods.some((method) => shouldSignProtocolMethod(method, capability, signing)) || legacyPoll;
+    const sign = signing.profile === "web-bot-auth" && !!operation && (0, import_protocol_methods.signingListIncludes)(capability?.profiles, "web-bot-auth") || shouldSignOperation(operation, capability, signing) || methods.some((method) => shouldSignProtocolMethod(method, capability, signing)) || signedPoll;
     if (sign && signing.profile === "web-bot-auth" && !(0, import_protocol_methods.signingListIncludes)(capability?.profiles, "web-bot-auth"))
       throw new TypeError("Seller did not advertise the Web Bot Auth request signing profile");
     return sign;

package/dist/lib/signing/agent-fetch.mjs

@@ -139,13 +139,13 @@ function buildAgentSigningFetch(options) {
     }
     const operation = extractAdcpOperation(init?.body);
     if (operation === "get_adcp_capabilities" && hasUnsignedCapabilityBootstrap(signing)) return false;
-    const isPollOperation = operation === "tasks_get" || operation === "tasks/get";
+    const isPollOperation = operation === "get_task_status" || operation === "tasks_get" || operation === "tasks/get";
     const methods = policyMethods ?? (isPollOperation ? jsonRpcMethodsForSigning(init?.body) : []);
     const profileCompatible = signing.profile === "web-bot-auth" ? signingListIncludes(capability?.profiles, "web-bot-auth") : capability?.profiles === void 0 || signingListIncludes(capability.profiles, "adcp/request-signing/v1");
-    const legacyPoll = profileCompatible && capability?.supported === true && (operation === "tasks_get" && methods.includes("tools/call") || operation === "tasks/get" && methods.some(
+    const signedPoll = profileCompatible && capability?.supported === true && ((operation === "tasks_get" || operation === "get_task_status") && methods.includes("tools/call") || (operation === "tasks/get" || operation === "get_task_status") && methods.some(
       (method) => ["message/send", "message/stream", "SendMessage", "SendStreamingMessage"].includes(method)
     ));
-    const sign = signing.profile === "web-bot-auth" && !!operation && signingListIncludes(capability?.profiles, "web-bot-auth") || shouldSignOperation(operation, capability, signing) || methods.some((method) => shouldSignProtocolMethod(method, capability, signing)) || legacyPoll;
+    const sign = signing.profile === "web-bot-auth" && !!operation && signingListIncludes(capability?.profiles, "web-bot-auth") || shouldSignOperation(operation, capability, signing) || methods.some((method) => shouldSignProtocolMethod(method, capability, signing)) || signedPoll;
     if (sign && signing.profile === "web-bot-auth" && !signingListIncludes(capability?.profiles, "web-bot-auth"))
       throw new TypeError("Seller did not advertise the Web Bot Auth request signing profile");
     return sign;

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

@@ -208,17 +208,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 +262,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 +292,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 +308,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 +332,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 +365,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 +380,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 +393,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 +413,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) {
@@ -737,7 +783,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

@@ -184,17 +184,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 +238,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 +268,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 +284,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 +308,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 +341,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 +356,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 +369,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 +389,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) {
@@ -713,7 +759,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;