@adcp/sdk 14.0.0-rc.44 → 14.0.0-rc.46

package/dist/lib/discovery/validate-adagents.d.mts

@@ -82,8 +82,8 @@ export interface ValidateAdAgentsOptions {
      * is used for every direct, authoritative-location, ads.txt, and manager
      * request, so `AbortSignal.timeout(...)` is an absolute operation deadline
      * rather than a fresh budget per hop. `timeoutMs` remains the ceiling for
-     * each individual request. Once aborted, discovery throws the abort reason
-     * and does not start a later fallback request.
+     * each individual request. Once aborted, discovery returns an invalid
+     * structured result and does not start a later fallback request.
      */
     signal?: AbortSignal;
     /** Maximum response body bytes for adagents.json and ads.txt fetches (default 256 KiB). */

package/dist/lib/discovery/validate-adagents.d.ts

@@ -82,8 +82,8 @@ export interface ValidateAdAgentsOptions {
      * is used for every direct, authoritative-location, ads.txt, and manager
      * request, so `AbortSignal.timeout(...)` is an absolute operation deadline
      * rather than a fresh budget per hop. `timeoutMs` remains the ceiling for
-     * each individual request. Once aborted, discovery throws the abort reason
-     * and does not start a later fallback request.
+     * each individual request. Once aborted, discovery returns an invalid
+     * structured result and does not start a later fallback request.
      */
     signal?: AbortSignal;
     /** Maximum response body bytes for adagents.json and ads.txt fetches (default 256 KiB). */

package/dist/lib/discovery/validate-adagents.js

@@ -304,9 +304,6 @@ async function rawFetch(url, opts) {
     const text = typeof decoded === "string" ? decoded : JSON.stringify(decoded);
     return { kind: "ok-text", text, url: result.url };
   } catch (err) {
-    if (opts.signal?.aborted || err instanceof Error && err.name === "AbortError") {
-      throw err;
-    }
     if (err instanceof import_adagents_redirects.AdAgentsRedirectRefusedError) {
       return { kind: "redirect_refused", message: err.message };
     }

package/dist/lib/discovery/validate-adagents.mjs

@@ -280,9 +280,6 @@ async function rawFetch(url, opts) {
     const text = typeof decoded === "string" ? decoded : JSON.stringify(decoded);
     return { kind: "ok-text", text, url: result.url };
   } catch (err) {
-    if (opts.signal?.aborted || err instanceof Error && err.name === "AbortError") {
-      throw err;
-    }
     if (err instanceof AdAgentsRedirectRefusedError) {
       return { kind: "redirect_refused", message: err.message };
     }

package/dist/lib/protocols/transportDiagnostics.js

@@ -147,10 +147,13 @@ function wrapFetchWithTransportDiagnostics(upstream) {
       };
       const responseBody = responseBodySnippet(response);
       if (!responseBody) {
-        emitTransportActivity(handler, {
-          ...responseEvent,
-          responseBodyTruncated: true
-        });
+        emitTransportActivity(
+          handler,
+          response.body ? {
+            ...responseEvent,
+            responseBodyTruncated: true
+          } : responseEvent
+        );
       } else {
         void responseBody.then(
           (captured) => {
@@ -219,12 +222,16 @@ function sanitizeResponseHeaders(headers) {
 }
 function headerEntries(headers) {
   if (!headers) return [];
-  if (headers instanceof Headers) {
+  if (Array.isArray(headers)) return headers.map(([key, value]) => [key, String(value)]);
+  const forEach = headers.forEach;
+  if (typeof forEach === "function") {
     const entries = [];
-    headers.forEach((value, key) => entries.push([key, value]));
-    return entries;
+    try {
+      forEach.call(headers, (value, key) => entries.push([String(key), String(value)]));
+      return entries;
+    } catch {
+    }
   }
-  if (Array.isArray(headers)) return headers.map(([key, value]) => [key, value]);
   return Object.entries(headers).map(([key, value]) => [key, String(value)]);
 }
 function isSafeCorrelationHeader(lower) {
@@ -251,7 +258,7 @@ function responseBodySnippet(response) {
   const contentType = response.headers.get("content-type") ?? "";
   if (!isDiagnosticTextContentType(contentType)) return void 0;
   const declaredLength = parseDiagnosticContentLength(response.headers.get("content-length"));
-  if (declaredLength !== void 0 && declaredLength > BODY_SNIPPET_LIMIT) return void 0;
+  if (declaredLength === void 0 || declaredLength > BODY_SNIPPET_LIMIT) return void 0;
   let diagnosticResponse;
   try {
     diagnosticResponse = response.clone();

package/dist/lib/protocols/transportDiagnostics.mjs

@@ -123,10 +123,13 @@ function wrapFetchWithTransportDiagnostics(upstream) {
       };
       const responseBody = responseBodySnippet(response);
       if (!responseBody) {
-        emitTransportActivity(handler, {
-          ...responseEvent,
-          responseBodyTruncated: true
-        });
+        emitTransportActivity(
+          handler,
+          response.body ? {
+            ...responseEvent,
+            responseBodyTruncated: true
+          } : responseEvent
+        );
       } else {
         void responseBody.then(
           (captured) => {
@@ -195,12 +198,16 @@ function sanitizeResponseHeaders(headers) {
 }
 function headerEntries(headers) {
   if (!headers) return [];
-  if (headers instanceof Headers) {
+  if (Array.isArray(headers)) return headers.map(([key, value]) => [key, String(value)]);
+  const forEach = headers.forEach;
+  if (typeof forEach === "function") {
     const entries = [];
-    headers.forEach((value, key) => entries.push([key, value]));
-    return entries;
+    try {
+      forEach.call(headers, (value, key) => entries.push([String(key), String(value)]));
+      return entries;
+    } catch {
+    }
   }
-  if (Array.isArray(headers)) return headers.map(([key, value]) => [key, value]);
   return Object.entries(headers).map(([key, value]) => [key, String(value)]);
 }
 function isSafeCorrelationHeader(lower) {
@@ -227,7 +234,7 @@ function responseBodySnippet(response) {
   const contentType = response.headers.get("content-type") ?? "";
   if (!isDiagnosticTextContentType(contentType)) return void 0;
   const declaredLength = parseDiagnosticContentLength(response.headers.get("content-length"));
-  if (declaredLength !== void 0 && declaredLength > BODY_SNIPPET_LIMIT) return void 0;
+  if (declaredLength === void 0 || declaredLength > BODY_SNIPPET_LIMIT) return void 0;
   let diagnosticResponse;
   try {
     diagnosticResponse = response.clone();

package/dist/lib/registry/types.generated.d.mts

@@ -4316,7 +4316,7 @@ export interface components {
             adcp_version: string;
             verified_at: string;
             /** @description Specialisms demonstrably passed (enums/specialism.json). Preview specialisms are excluded from stable badges. */
-            verified_specialisms: ("audience-sync" | "brand-rights" | "buyer-activation" | "buyer-discovery" | "buyer-monitoring" | "buyer-negotiation" | "buyer-recovery" | "collection-lists" | "content-standards" | "creative-ad-server" | "creative-generative" | "creative-template" | "creative-transformers" | "governance-aware-seller" | "governance-delivery-monitor" | "governance-spend-authority" | "property-lists" | "sales-broadcast-tv" | "sales-catalog-driven" | "sales-dooh" | "sales-guaranteed" | "sales-non-guaranteed" | "sales-proposal-mode" | "sales-social" | "signal-marketplace" | "orchestrator-multi-agent" | "signal-owned" | "signed-requests" | "sponsored-intelligence")[];
+            verified_specialisms: ("audience-sync" | "brand-rights" | "buyer-activation" | "buyer-discovery" | "buyer-monitoring" | "buyer-negotiation" | "buyer-recovery" | "collection-lists" | "content-standards" | "creative-ad-server" | "creative-generative" | "creative-template" | "creative-transformers" | "governance-aware-seller" | "governance-delivery-monitor" | "governance-spend-authority" | "property-lists" | "sales-broadcast-tv" | "sales-catalog-driven" | "sales-dooh" | "sales-exchange" | "sales-guaranteed" | "sales-non-guaranteed" | "sales-proposal-mode" | "sales-retail-media" | "sales-streaming-tv" | "sales-social" | "signal-marketplace" | "orchestrator-multi-agent" | "signal-owned" | "signed-requests" | "sponsored-intelligence")[];
             /** @description Evidence modes earned. 'spec' = AdCP storyboards were exercised; 'live' = production traffic was observed. Independent of grading_profile and always non-empty when a badge is present. */
             verification_modes: ("spec" | "live")[];
             /**

package/dist/lib/registry/types.generated.d.ts

@@ -4316,7 +4316,7 @@ export interface components {
             adcp_version: string;
             verified_at: string;
             /** @description Specialisms demonstrably passed (enums/specialism.json). Preview specialisms are excluded from stable badges. */
-            verified_specialisms: ("audience-sync" | "brand-rights" | "buyer-activation" | "buyer-discovery" | "buyer-monitoring" | "buyer-negotiation" | "buyer-recovery" | "collection-lists" | "content-standards" | "creative-ad-server" | "creative-generative" | "creative-template" | "creative-transformers" | "governance-aware-seller" | "governance-delivery-monitor" | "governance-spend-authority" | "property-lists" | "sales-broadcast-tv" | "sales-catalog-driven" | "sales-dooh" | "sales-guaranteed" | "sales-non-guaranteed" | "sales-proposal-mode" | "sales-social" | "signal-marketplace" | "orchestrator-multi-agent" | "signal-owned" | "signed-requests" | "sponsored-intelligence")[];
+            verified_specialisms: ("audience-sync" | "brand-rights" | "buyer-activation" | "buyer-discovery" | "buyer-monitoring" | "buyer-negotiation" | "buyer-recovery" | "collection-lists" | "content-standards" | "creative-ad-server" | "creative-generative" | "creative-template" | "creative-transformers" | "governance-aware-seller" | "governance-delivery-monitor" | "governance-spend-authority" | "property-lists" | "sales-broadcast-tv" | "sales-catalog-driven" | "sales-dooh" | "sales-exchange" | "sales-guaranteed" | "sales-non-guaranteed" | "sales-proposal-mode" | "sales-retail-media" | "sales-streaming-tv" | "sales-social" | "signal-marketplace" | "orchestrator-multi-agent" | "signal-owned" | "signed-requests" | "sponsored-intelligence")[];
             /** @description Evidence modes earned. 'spec' = AdCP storyboards were exercised; 'live' = production traffic was observed. Independent of grading_profile and always non-empty when a badge is present. */
             verification_modes: ("spec" | "live")[];
             /**

package/dist/lib/reporting/reconciliation.js

@@ -419,22 +419,16 @@ function assertReportingLedgerGraph(accountId, obligations, revisions, materiali
     }
     referencedRevisions.add(materialization.reporting_revision_id);
   }
-  const materializedObligations = new Set(
-    [...materializations.values()].map((materialization) => materialization.reporting_obligation_id)
-  );
-  const directCoreScopeCounts = /* @__PURE__ */ new Map();
+  const obligationScopes = /* @__PURE__ */ new Set();
   for (const obligation of obligations.values()) {
-    if (!isDirectCoreObligation(obligation) || !Array.isArray(obligation.media_buy_ids) || materializedObligations.has(obligation.reporting_obligation_id)) {
-      continue;
+    if (Array.isArray(obligation.media_buy_ids)) {
+      obligationScopes.add(reportingRevisionScopeKey(obligation));
     }
-    const scopeKey = reportingRevisionScopeKey(obligation);
-    directCoreScopeCounts.set(scopeKey, (directCoreScopeCounts.get(scopeKey) ?? 0) + 1);
   }
   for (const revision of revisions.values()) {
     const referenced = referencedRevisions.has(revision.reporting_revision_id);
-    const directCoreScopeCount = Array.isArray(revision.media_buy_ids) ? directCoreScopeCounts.get(reportingRevisionScopeKey(revision)) ?? 0 : 0;
-    const directlyScopedCoreRevision = directCoreScopeCount > 0;
-    if (revision.account_id !== accountId || !referenced && !directlyScopedCoreRevision || !(0, import_evidence.isReportingControlTotals)(revision.control_totals)) {
+    const scoped = Array.isArray(revision.media_buy_ids) && obligationScopes.has(reportingRevisionScopeKey(revision));
+    if (revision.account_id !== accountId || !referenced && !scoped || !(0, import_evidence.isReportingControlTotals)(revision.control_totals)) {
       fail();
     }
   }
@@ -447,9 +441,6 @@ function assertReportingLedgerGraph(accountId, obligations, revisions, materiali
     }
   }
 }
-function isDirectCoreObligation(obligation) {
-  return obligation.reconciliation_mode === "delivery_only" && obligation.destination_ref === void 0;
-}
 function revisionMatchesObligationScope(revision, obligation) {
   return revision.account_id === obligation.account_id && revision.report_definition_id === obligation.report_definition_id && revision.reporting_profile === obligation.reporting_profile && Array.isArray(revision.media_buy_ids) && Array.isArray(obligation.media_buy_ids) && sameStringSet(revision.media_buy_ids, obligation.media_buy_ids) && same(revision.period, obligation.period);
 }
@@ -481,10 +472,9 @@ function selectCurrent(obligation, ledger, expected) {
     (item) => item.reporting_obligation_id === obligation.reporting_obligation_id
   );
   const revisionIds = new Set(attempts.map((item) => item.reporting_revision_id));
-  const candidates = ledger.revisions.filter((item) => {
-    if (attempts.length > 0) return revisionIds.has(item.reporting_revision_id);
-    return isDirectCoreObligation(obligation) && revisionMatchesObligationScope(item, obligation);
-  });
+  const candidates = ledger.revisions.filter(
+    (item) => revisionIds.has(item.reporting_revision_id) || revisionMatchesObligationScope(item, obligation)
+  );
   const receipts = ledger.receipts.filter((item) => item.reporting_obligation_id === obligation.reporting_obligation_id);
   const successfulAttempts = attempts.filter((item) => item.status === "available" || item.status === "delivered");
   const acceptedReceipts = receipts.filter((item) => item.status === "accepted");
@@ -499,12 +489,33 @@ function selectCurrent(obligation, ledger, expected) {
   ) || countMismatch(obligation.receipt_count, receipts.length, receiptCountsRequired) || countMismatch(obligation.accepted_receipt_count, acceptedReceipts.length, receiptCountsRequired)) {
     reasons.push("ASSOCIATED_HISTORY_INCOMPLETE");
   }
-  const superseded = new Set(
-    candidates.map((item) => item.supersedes_reporting_revision_id).filter((id) => Boolean(id))
-  );
-  const candidateIds = new Set(candidates.map((item) => item.reporting_revision_id));
+  const candidateById = new Map(candidates.map((item) => [item.reporting_revision_id, item]));
+  const superseded = /* @__PURE__ */ new Set();
+  let invalidTopology = false;
+  for (const candidate of candidates) {
+    const predecessorId = candidate.supersedes_reporting_revision_id;
+    if (!predecessorId) continue;
+    if (superseded.has(predecessorId) || candidateById.get(predecessorId)?.finality === "official") {
+      invalidTopology = true;
+    }
+    superseded.add(predecessorId);
+  }
+  const checked = /* @__PURE__ */ new Set();
+  for (const candidate of candidates) {
+    const path = /* @__PURE__ */ new Set();
+    let cursor = candidate;
+    while (cursor && !checked.has(cursor.reporting_revision_id)) {
+      if (path.has(cursor.reporting_revision_id)) {
+        invalidTopology = true;
+        break;
+      }
+      path.add(cursor.reporting_revision_id);
+      cursor = candidateById.get(cursor.supersedes_reporting_revision_id ?? "");
+    }
+    for (const id of path) checked.add(id);
+  }
   if (candidates.some(
-    (item) => item.supersedes_reporting_revision_id && !candidateIds.has(item.supersedes_reporting_revision_id)
+    (item) => item.supersedes_reporting_revision_id && !candidateById.has(item.supersedes_reporting_revision_id)
   )) {
     reasons.push("REVISION_PREDECESSOR_MISSING");
   }
@@ -514,11 +525,16 @@ function selectCurrent(obligation, ledger, expected) {
     reasons.push("REVISION_CHAIN_SCOPE_MISMATCH");
   }
   const current = candidates.filter((item) => !superseded.has(item.reporting_revision_id));
-  if (current.length !== 1) {
-    reasons.push(current.length === 0 ? "MISSING_CURRENT_REVISION" : "AMBIGUOUS_REVISION_CHAIN");
+  const officials = candidates.filter((item) => item.finality === "official");
+  if (invalidTopology || officials.length > 1 || current.length > 2 || current.length === 2 && officials.length !== 1) {
+    reasons.push("AMBIGUOUS_REVISION_CHAIN");
+    return { reasons };
+  }
+  const revision = officials[0] ?? current[0];
+  if (!revision) {
+    reasons.push("MISSING_CURRENT_REVISION");
     return { reasons };
   }
-  const revision = current[0];
   const revisionControlTotalsValid = (0, import_evidence.isReportingControlTotals)(revision.control_totals);
   if (!revisionControlTotalsValid) reasons.push("REVISION_CONTROL_TOTALS_INVALID");
   if (!revision.report_definition_uri || !revision.report_definition_sha256) {

package/dist/lib/reporting/reconciliation.mjs

@@ -396,22 +396,16 @@ function assertReportingLedgerGraph(accountId, obligations, revisions, materiali
     }
     referencedRevisions.add(materialization.reporting_revision_id);
   }
-  const materializedObligations = new Set(
-    [...materializations.values()].map((materialization) => materialization.reporting_obligation_id)
-  );
-  const directCoreScopeCounts = /* @__PURE__ */ new Map();
+  const obligationScopes = /* @__PURE__ */ new Set();
   for (const obligation of obligations.values()) {
-    if (!isDirectCoreObligation(obligation) || !Array.isArray(obligation.media_buy_ids) || materializedObligations.has(obligation.reporting_obligation_id)) {
-      continue;
+    if (Array.isArray(obligation.media_buy_ids)) {
+      obligationScopes.add(reportingRevisionScopeKey(obligation));
     }
-    const scopeKey = reportingRevisionScopeKey(obligation);
-    directCoreScopeCounts.set(scopeKey, (directCoreScopeCounts.get(scopeKey) ?? 0) + 1);
   }
   for (const revision of revisions.values()) {
     const referenced = referencedRevisions.has(revision.reporting_revision_id);
-    const directCoreScopeCount = Array.isArray(revision.media_buy_ids) ? directCoreScopeCounts.get(reportingRevisionScopeKey(revision)) ?? 0 : 0;
-    const directlyScopedCoreRevision = directCoreScopeCount > 0;
-    if (revision.account_id !== accountId || !referenced && !directlyScopedCoreRevision || !isReportingControlTotals(revision.control_totals)) {
+    const scoped = Array.isArray(revision.media_buy_ids) && obligationScopes.has(reportingRevisionScopeKey(revision));
+    if (revision.account_id !== accountId || !referenced && !scoped || !isReportingControlTotals(revision.control_totals)) {
       fail();
     }
   }
@@ -424,9 +418,6 @@ function assertReportingLedgerGraph(accountId, obligations, revisions, materiali
     }
   }
 }
-function isDirectCoreObligation(obligation) {
-  return obligation.reconciliation_mode === "delivery_only" && obligation.destination_ref === void 0;
-}
 function revisionMatchesObligationScope(revision, obligation) {
   return revision.account_id === obligation.account_id && revision.report_definition_id === obligation.report_definition_id && revision.reporting_profile === obligation.reporting_profile && Array.isArray(revision.media_buy_ids) && Array.isArray(obligation.media_buy_ids) && sameStringSet(revision.media_buy_ids, obligation.media_buy_ids) && same(revision.period, obligation.period);
 }
@@ -458,10 +449,9 @@ function selectCurrent(obligation, ledger, expected) {
     (item) => item.reporting_obligation_id === obligation.reporting_obligation_id
   );
   const revisionIds = new Set(attempts.map((item) => item.reporting_revision_id));
-  const candidates = ledger.revisions.filter((item) => {
-    if (attempts.length > 0) return revisionIds.has(item.reporting_revision_id);
-    return isDirectCoreObligation(obligation) && revisionMatchesObligationScope(item, obligation);
-  });
+  const candidates = ledger.revisions.filter(
+    (item) => revisionIds.has(item.reporting_revision_id) || revisionMatchesObligationScope(item, obligation)
+  );
   const receipts = ledger.receipts.filter((item) => item.reporting_obligation_id === obligation.reporting_obligation_id);
   const successfulAttempts = attempts.filter((item) => item.status === "available" || item.status === "delivered");
   const acceptedReceipts = receipts.filter((item) => item.status === "accepted");
@@ -476,12 +466,33 @@ function selectCurrent(obligation, ledger, expected) {
   ) || countMismatch(obligation.receipt_count, receipts.length, receiptCountsRequired) || countMismatch(obligation.accepted_receipt_count, acceptedReceipts.length, receiptCountsRequired)) {
     reasons.push("ASSOCIATED_HISTORY_INCOMPLETE");
   }
-  const superseded = new Set(
-    candidates.map((item) => item.supersedes_reporting_revision_id).filter((id) => Boolean(id))
-  );
-  const candidateIds = new Set(candidates.map((item) => item.reporting_revision_id));
+  const candidateById = new Map(candidates.map((item) => [item.reporting_revision_id, item]));
+  const superseded = /* @__PURE__ */ new Set();
+  let invalidTopology = false;
+  for (const candidate of candidates) {
+    const predecessorId = candidate.supersedes_reporting_revision_id;
+    if (!predecessorId) continue;
+    if (superseded.has(predecessorId) || candidateById.get(predecessorId)?.finality === "official") {
+      invalidTopology = true;
+    }
+    superseded.add(predecessorId);
+  }
+  const checked = /* @__PURE__ */ new Set();
+  for (const candidate of candidates) {
+    const path = /* @__PURE__ */ new Set();
+    let cursor = candidate;
+    while (cursor && !checked.has(cursor.reporting_revision_id)) {
+      if (path.has(cursor.reporting_revision_id)) {
+        invalidTopology = true;
+        break;
+      }
+      path.add(cursor.reporting_revision_id);
+      cursor = candidateById.get(cursor.supersedes_reporting_revision_id ?? "");
+    }
+    for (const id of path) checked.add(id);
+  }
   if (candidates.some(
-    (item) => item.supersedes_reporting_revision_id && !candidateIds.has(item.supersedes_reporting_revision_id)
+    (item) => item.supersedes_reporting_revision_id && !candidateById.has(item.supersedes_reporting_revision_id)
   )) {
     reasons.push("REVISION_PREDECESSOR_MISSING");
   }
@@ -491,11 +502,16 @@ function selectCurrent(obligation, ledger, expected) {
     reasons.push("REVISION_CHAIN_SCOPE_MISMATCH");
   }
   const current = candidates.filter((item) => !superseded.has(item.reporting_revision_id));
-  if (current.length !== 1) {
-    reasons.push(current.length === 0 ? "MISSING_CURRENT_REVISION" : "AMBIGUOUS_REVISION_CHAIN");
+  const officials = candidates.filter((item) => item.finality === "official");
+  if (invalidTopology || officials.length > 1 || current.length > 2 || current.length === 2 && officials.length !== 1) {
+    reasons.push("AMBIGUOUS_REVISION_CHAIN");
+    return { reasons };
+  }
+  const revision = officials[0] ?? current[0];
+  if (!revision) {
+    reasons.push("MISSING_CURRENT_REVISION");
     return { reasons };
   }
-  const revision = current[0];
   const revisionControlTotalsValid = isReportingControlTotals(revision.control_totals);
   if (!revisionControlTotalsValid) reasons.push("REVISION_CONTROL_TOTALS_INVALID");
   if (!revision.report_definition_uri || !revision.report_definition_sha256) {

package/dist/lib/schemas-data/v2.5/_provenance.json

@@ -4,5 +4,5 @@
   "source_sha": "4e553ad955f83b49c7d221ab5c3ff78237ad02e3",
   "source_tarball_sha256": "580656d6466ef9f0d1119985e6726c2efea718dc671e2ad30957fcb2fd54af0f",
   "upstream_adcp_version": "2.5.3",
-  "synced_at": "2026-09-22T10:35:10.302Z"
+  "synced_at": "2026-09-22T19:09:10.936Z"
 }

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

@@ -448,8 +448,9 @@ function loadSpecialismDetail(slug, options = {}) {
   }
   const required = [];
   const unresolved = [];
+  const storyboardsById = new Map(listAllComplianceStoryboards(options).map((sb) => [sb.id, sb]));
   for (const ref of storyboard.requires_scenarios ?? []) {
-    const sb = getComplianceStoryboardById(ref, options);
+    const sb = storyboardsById.get(ref);
     if (sb) required.push(sb);
     else unresolved.push(ref);
   }

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

@@ -413,8 +413,9 @@ function loadSpecialismDetail(slug, options = {}) {
   }
   const required = [];
   const unresolved = [];
+  const storyboardsById = new Map(listAllComplianceStoryboards(options).map((sb) => [sb.id, sb]));
   for (const ref of storyboard.requires_scenarios ?? []) {
-    const sb = getComplianceStoryboardById(ref, options);
+    const sb = storyboardsById.get(ref);
     if (sb) required.push(sb);
     else unresolved.push(ref);
   }

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 = "14.0.0-rc.44";
+export declare const RUNNER_CAPABILITY_VERSION = "14.0.0-rc.46";
 /** 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 = "14.0.0-rc.44";
+export declare const RUNNER_CAPABILITY_VERSION = "14.0.0-rc.46";
 /** True when a failed validation contributes to the owning step's grade. */
 export declare function validationFailsStep(result: ValidationResult): boolean;
 /**

package/dist/lib/v2/projection/creative-delivery.js

@@ -537,7 +537,7 @@ function selectLegacyRef(creative, container, canonicalFormatLegacyResolver, ope
       return void 0;
     }
     candidates = candidates.filter(
-      (candidate) => candidate.formatOptionRef && sameOptionReference(candidate.formatOptionRef, creativeOptionRef)
+      (candidate) => candidate.formatOptionRef ? sameOptionReference(candidate.formatOptionRef, creativeOptionRef) : (0, import_v1_to_v2.migratedFormatOptionId)(candidate.ref) === creativeOptionRef.format_option_id
     );
   } else if (selectedOptionRefs.length > 0) {
     candidates = candidates.filter(
@@ -850,6 +850,10 @@ function projectCreativeForDelivery(creative, selectorContainer, wireMode = "can
       );
     }
     if (resolved) return projectCreative(creativeRecord, resolved[0]);
+    const pinned = optionReference(creativeRecord.format_option_ref) !== void 0;
+    if (candidates.length === 1 && !pinned) {
+      return projectCreative(creativeRecord, candidates[0].ref);
+    }
     if (candidates.length > 1) {
       throw new CreativeFormatProjectionError(
         operation,
@@ -857,7 +861,7 @@ function projectCreativeForDelivery(creative, selectorContainer, wireMode = "can
         `the seller advertised ${candidates.length} legacy refs for canonical kind ${creativeRecord.format_kind}`
       );
     }
-    const reason = "the selected seller product did not provide one unambiguous legacy format reference";
+    const reason = pinned ? "the creative is pinned to a format option that names none of the selected seller product legacy format references" : "the selected seller product did not provide one unambiguous legacy format reference";
     throw new CreativeFormatProjectionError(operation, creativeId, reason);
   }
   return creative;

package/dist/lib/v2/projection/creative-delivery.mjs

@@ -1,4 +1,9 @@
-import { canonicalDeclarationFromBareId, projectV1ProductToV2, resolveCanonicalFormatKind } from "./v1-to-v2.mjs";
+import {
+  canonicalDeclarationFromBareId,
+  migratedFormatOptionId,
+  projectV1ProductToV2,
+  resolveCanonicalFormatKind
+} from "./v1-to-v2.mjs";
 import { CanonicalFormatLegacyResolutionError, resolveCanonicalFormatLegacyRefs } from "./v2-to-v1.mjs";
 import {
   legacyFormatRefsForDeclaration,
@@ -512,7 +517,7 @@ function selectLegacyRef(creative, container, canonicalFormatLegacyResolver, ope
       return void 0;
     }
     candidates = candidates.filter(
-      (candidate) => candidate.formatOptionRef && sameOptionReference(candidate.formatOptionRef, creativeOptionRef)
+      (candidate) => candidate.formatOptionRef ? sameOptionReference(candidate.formatOptionRef, creativeOptionRef) : migratedFormatOptionId(candidate.ref) === creativeOptionRef.format_option_id
     );
   } else if (selectedOptionRefs.length > 0) {
     candidates = candidates.filter(
@@ -825,6 +830,10 @@ function projectCreativeForDelivery(creative, selectorContainer, wireMode = "can
       );
     }
     if (resolved) return projectCreative(creativeRecord, resolved[0]);
+    const pinned = optionReference(creativeRecord.format_option_ref) !== void 0;
+    if (candidates.length === 1 && !pinned) {
+      return projectCreative(creativeRecord, candidates[0].ref);
+    }
     if (candidates.length > 1) {
       throw new CreativeFormatProjectionError(
         operation,
@@ -832,7 +841,7 @@ function projectCreativeForDelivery(creative, selectorContainer, wireMode = "can
         `the seller advertised ${candidates.length} legacy refs for canonical kind ${creativeRecord.format_kind}`
       );
     }
-    const reason = "the selected seller product did not provide one unambiguous legacy format reference";
+    const reason = pinned ? "the creative is pinned to a format option that names none of the selected seller product legacy format references" : "the selected seller product did not provide one unambiguous legacy format reference";
     throw new CreativeFormatProjectionError(operation, creativeId, reason);
   }
   return creative;

package/dist/lib/v2/projection/v1-to-v2.d.mts

@@ -48,6 +48,13 @@
 import type { V1ProductInput, V1FormatId, V2Product, V2ProductFormatDeclaration, ProjectionDiagnostic, CanonicalFormatKind } from './types.mjs';
 import { type ProjectionCatalogSnapshot } from './catalog-snapshot.mjs';
 import type { CanonicalFormatLegacyRoute } from './legacy-routes.mjs';
+/**
+ * Give an unnamed projected option a stable, opaque identity derived from the
+ * complete legacy tuple. Positional IDs are unsafe: a seller reordering its
+ * `format_ids` array could otherwise make a persisted canonical selection
+ * resolve to a different legacy format on the next discovery refresh.
+ */
+export declare function migratedFormatOptionId(fid: V1FormatId): string;
 export interface V1ToV2Result {
     v2: V2Product;
     diagnostics: ProjectionDiagnostic[];

package/dist/lib/v2/projection/v1-to-v2.d.ts

@@ -48,6 +48,13 @@
 import type { V1ProductInput, V1FormatId, V2Product, V2ProductFormatDeclaration, ProjectionDiagnostic, CanonicalFormatKind } from './types';
 import { type ProjectionCatalogSnapshot } from './catalog-snapshot';
 import type { CanonicalFormatLegacyRoute } from './legacy-routes';
+/**
+ * Give an unnamed projected option a stable, opaque identity derived from the
+ * complete legacy tuple. Positional IDs are unsafe: a seller reordering its
+ * `format_ids` array could otherwise make a persisted canonical selection
+ * resolve to a different legacy format on the next discovery refresh.
+ */
+export declare function migratedFormatOptionId(fid: V1FormatId): string;
 export interface V1ToV2Result {
     v2: V2Product;
     diagnostics: ProjectionDiagnostic[];

package/dist/lib/v2/projection/v1-to-v2.js

@@ -19,6 +19,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var v1_to_v2_exports = {};
 __export(v1_to_v2_exports, {
   canonicalDeclarationFromBareId: () => canonicalDeclarationFromBareId,
+  migratedFormatOptionId: () => migratedFormatOptionId,
   projectV1ProductToV2: () => projectV1ProductToV2,
   resolveCanonicalFormatKind: () => resolveCanonicalFormatKind
 });
@@ -369,6 +370,7 @@ function resolveCanonicalFormatKind(id, options) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   canonicalDeclarationFromBareId,
+  migratedFormatOptionId,
   projectV1ProductToV2,
   resolveCanonicalFormatKind
 });

package/dist/lib/v2/projection/v1-to-v2.mjs

@@ -348,6 +348,7 @@ function resolveCanonicalFormatKind(id, options) {
 }
 export {
   canonicalDeclarationFromBareId,
+  migratedFormatOptionId,
   projectV1ProductToV2,
   resolveCanonicalFormatKind
 };

package/dist/lib/version.d.mts

@@ -1,7 +1,7 @@
 /**
  * AdCP SDK library version
  */
-export declare const LIBRARY_VERSION = "14.0.0-rc.44";
+export declare const LIBRARY_VERSION = "14.0.0-rc.46";
 /**
  * AdCP specification version this library is built for
  */
@@ -33,10 +33,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
  * Full version information
  */
 export declare const VERSION_INFO: {
-    readonly library: "14.0.0-rc.44";
+    readonly library: "14.0.0-rc.46";
     readonly adcp: "3.2.0-rc.4";
     readonly compatibleVersions: readonly ["v2.5", "v2.6", "v3", "3.0.0", "3.0", "3.0.1", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7", "3.0.8", "3.0.9", "3.0.10", "3.0.11", "3.0.12", "3.0.13", "3.0.14", "3.0.15", "3.0.16", "3.0.17", "3.0.18", "3.0.19", "3.0.20", "3.0.21", "3.0.22", "3.0.23", "3.0.24", "3.0.25", "3.1.0", "3.1", "3.1.1", "3.1.2", "3.1.3", "3.1.4", "3.1.5", "3.1.6", "3.1.7", "3.1.8", "3.1.9", "3.1.10", "3.1.11", "3.1.12", "3.1.13", "3.1.14", "3.1.15", "3.1.16", "3.1.17", "3.1.18", "3.2.0-rc.4", "3.2-rc.4"];
-    readonly generatedAt: "2026-09-22T10:18:01.112Z";
+    readonly generatedAt: "2026-09-22T18:08:14.356Z";
 };
 /**
  * Get the AdCP specification version this library is built for

package/dist/lib/version.d.ts

@@ -1,7 +1,7 @@
 /**
  * AdCP SDK library version
  */
-export declare const LIBRARY_VERSION = "14.0.0-rc.44";
+export declare const LIBRARY_VERSION = "14.0.0-rc.46";
 /**
  * AdCP specification version this library is built for
  */
@@ -33,10 +33,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
  * Full version information
  */
 export declare const VERSION_INFO: {
-    readonly library: "14.0.0-rc.44";
+    readonly library: "14.0.0-rc.46";
     readonly adcp: "3.2.0-rc.4";
     readonly compatibleVersions: readonly ["v2.5", "v2.6", "v3", "3.0.0", "3.0", "3.0.1", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7", "3.0.8", "3.0.9", "3.0.10", "3.0.11", "3.0.12", "3.0.13", "3.0.14", "3.0.15", "3.0.16", "3.0.17", "3.0.18", "3.0.19", "3.0.20", "3.0.21", "3.0.22", "3.0.23", "3.0.24", "3.0.25", "3.1.0", "3.1", "3.1.1", "3.1.2", "3.1.3", "3.1.4", "3.1.5", "3.1.6", "3.1.7", "3.1.8", "3.1.9", "3.1.10", "3.1.11", "3.1.12", "3.1.13", "3.1.14", "3.1.15", "3.1.16", "3.1.17", "3.1.18", "3.2.0-rc.4", "3.2-rc.4"];
-    readonly generatedAt: "2026-09-22T10:18:01.112Z";
+    readonly generatedAt: "2026-09-22T18:08:14.356Z";
 };
 /**
  * Get the AdCP specification version this library is built for

package/dist/lib/version.js

@@ -31,7 +31,7 @@ __export(version_exports, {
   toReleasePrecisionVersion: () => toReleasePrecisionVersion
 });
 module.exports = __toCommonJS(version_exports);
-const LIBRARY_VERSION = "14.0.0-rc.44";
+const LIBRARY_VERSION = "14.0.0-rc.46";
 const ADCP_VERSION = "3.2.0-rc.4";
 const ADCP_MAJOR_VERSION = 3;
 const COMPATIBLE_ADCP_VERSIONS = [
@@ -89,10 +89,10 @@ const COMPATIBLE_ADCP_VERSIONS = [
   "3.2-rc.4"
 ];
 const VERSION_INFO = {
-  library: "14.0.0-rc.44",
+  library: "14.0.0-rc.46",
   adcp: "3.2.0-rc.4",
   compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
-  generatedAt: "2026-09-22T10:18:01.112Z"
+  generatedAt: "2026-09-22T18:08:14.356Z"
 };
 function getAdcpVersion() {
   return ADCP_VERSION;

package/dist/lib/version.mjs

@@ -1,4 +1,4 @@
-const LIBRARY_VERSION = "14.0.0-rc.44";
+const LIBRARY_VERSION = "14.0.0-rc.46";
 const ADCP_VERSION = "3.2.0-rc.4";
 const ADCP_MAJOR_VERSION = 3;
 const COMPATIBLE_ADCP_VERSIONS = [
@@ -56,10 +56,10 @@ const COMPATIBLE_ADCP_VERSIONS = [
   "3.2-rc.4"
 ];
 const VERSION_INFO = {
-  library: "14.0.0-rc.44",
+  library: "14.0.0-rc.46",
   adcp: "3.2.0-rc.4",
   compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
-  generatedAt: "2026-09-22T10:18:01.112Z"
+  generatedAt: "2026-09-22T18:08:14.356Z"
 };
 function getAdcpVersion() {
   return ADCP_VERSION;

package/docs/TYPE-SUMMARY.md

@@ -1,7 +1,7 @@
 # AdCP Type Summary
 
 > Generated at: 2026-09-22
-> @adcp/sdk v14.0.0-rc.44
+> @adcp/sdk v14.0.0-rc.46
 
 Curated reference of the types that matter for using the AdCP client. For full generated types see `src/lib/types/tools.generated.ts` and `src/lib/types/core.generated.ts`.
 

package/docs/guides/REPORTING-RECONCILIATION.md

@@ -109,6 +109,8 @@ The helper only returns `definitive: true` when all of these conditions hold:
 
 An omitted expected-period denominator can still diagnose delivery, but can never prove completeness. Pass `[]` only when the buyer independently knows that no periods are expected in the requested scope.
 
+A unique official revision takes precedence over a retained snapshot even without an explicit supersession link. The logical-slice join includes owned revisions whose destination materialization is still pending. In that case the result names the official revision, remains nondefinitive with `MISSING_VERIFIED_MATERIALIZATION`, and does not inspect or receipt the older snapshot. Forks, cycles, multiple official revisions, incomplete history, and mismatched ownership still prevent definitive reconciliation; the seller's retained records are preserved.
+
 ```ts
 import {
   createHttpsReportingResourceReader,

package/docs/llms.txt

@@ -1,7 +1,7 @@
 # Ad Context Protocol (AdCP)
 
 > Generated at: 2026-09-22
-> Library: @adcp/sdk v14.0.0-rc.44
+> Library: @adcp/sdk v14.0.0-rc.46
 > AdCP major version: 3
 > Canonical URL: https://adcontextprotocol.github.io/adcp-client/llms.txt
 > Note: the `Library` stamp reflects the package.json version at doc-generation time. The narrative below describes the surface that lands on the next-published minor — including any 6.7 helpers documented here ahead of the release tag.

package/docs/migration-14.x-rc-worksheet.md

@@ -11,8 +11,8 @@ below as the publication/deployment gate.
 
 | Fact | Value |
 | --- | --- |
-| Exact npm package | `@adcp/sdk@14.0.0-rc.44` |
-| npm integrity | registry-derived after publication; run `npm view @adcp/sdk@14.0.0-rc.44 dist.integrity` |
+| Exact npm package | `@adcp/sdk@14.0.0-rc.46` |
+| npm integrity | registry-derived after publication; run `npm view @adcp/sdk@14.0.0-rc.46 dist.integrity` |
 | Node.js runtime | `^20.19.0 || >=22.12.0` |
 | Default AdCP wire release | `3.2.0-rc.4` |
 | Maintained wire releases | `v2.5`, `v2.6`, `v3`, `3.0.0`, `3.0`, `3.0.1`, `3.0.2`, `3.0.3`, `3.0.4`, `3.0.5`, `3.0.6`, `3.0.7`, `3.0.8`, `3.0.9`, `3.0.10`, `3.0.11`, `3.0.12`, `3.0.13`, `3.0.14`, `3.0.15`, `3.0.16`, `3.0.17`, `3.0.18`, `3.0.19`, `3.0.20`, `3.0.21`, `3.0.22`, `3.0.23`, `3.0.24`, `3.0.25`, `3.1.0`, `3.1`, `3.1.1`, `3.1.2`, `3.1.3`, `3.1.4`, `3.1.5`, `3.1.6`, `3.1.7`, `3.1.8`, `3.1.9`, `3.1.10`, `3.1.11`, `3.1.12`, `3.1.13`, `3.1.14`, `3.1.15`, `3.1.16`, `3.1.17`, `3.1.18`, `3.2.0-rc.4`, `3.2-rc.4` |
@@ -21,8 +21,8 @@ below as the publication/deployment gate.
 Install exact production inputs rather than a moving prerelease range:
 
 ```bash
-npm install --save-exact '@adcp/sdk@14.0.0-rc.44'
-npm view '@adcp/sdk@14.0.0-rc.44' dist.integrity
+npm install --save-exact '@adcp/sdk@14.0.0-rc.46'
+npm view '@adcp/sdk@14.0.0-rc.46' dist.integrity
 ```
 
 ### Required and optional peers

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adcp/sdk",
-  "version": "14.0.0-rc.44",
+  "version": "14.0.0-rc.46",
   "description": "AdCP SDK — client, server, and compliance harnesses for the AdContext Protocol (MCP + A2A)",
   "workspaces": [
     ".",