@adcp/sdk 15.7.1 → 15.8.0

package/dist/lib/testing/storyboard/request-builder.mjs

@@ -6,25 +6,25 @@ const UNKNOWN_FORMAT_ID = Object.freeze({ agent_url: "https://unknown.example.co
 const FALLBACK_CALLER_AGENT_URL = "https://e2e-orchestrator.adcontextprotocol.org/";
 const FIXTURE_AWARE_ENRICHERS = /* @__PURE__ */ new Set([
   "create_media_buy",
-  // merges discovery-derived product_id / pricing_option_id INTO fixture packages[0]
+  // preserves authored accounts and merges discovered identifiers INTO fixture packages[0]
   "comply_test_controller",
   // forces account.sandbox: true regardless of fixture
   "check_governance",
   // preserves the authored intent-vs-delivery request shape
   "get_products",
-  // preserves wholesale fixture fields while keeping resolved account scope authoritative
+  // preserves discovery fields and authored account identities
   "get_signals",
-  // preserves discovery fields while keeping async task account scope authoritative
+  // preserves discovery fields and authored account identities
   "get_task_status",
-  // preserves task filters while keeping resolved account scope authoritative
+  // preserves task filters and authored account identities
   "list_tasks",
-  // preserves reconciliation filters while keeping resolved account scope authoritative
+  // preserves reconciliation filters and authored account identities
   "update_media_buy",
-  // resolves account via resolveAccount(options) so sandbox routing matches create_media_buy
+  // fills missing account identity and carries sandbox routing into authored natural keys
   "get_media_buys",
-  // resolves account via resolveAccount(options) so sandbox routing matches create_media_buy
+  // fills missing account identity and carries sandbox routing into authored natural keys
   "get_media_buy_delivery"
-  // resolves account via resolveAccount(options) so sandbox routing matches create_media_buy
+  // fills missing account identity and carries sandbox routing into authored natural keys
 ]);
 function hasUnresolvedContextReference(value) {
   if (typeof value === "string") return /^\$context\.\w+$/.test(value);
@@ -67,23 +67,21 @@ function runClockMs(runnerVars) {
   return runnerVars?.runStartMs ?? Date.now();
 }
 function resolveMediaBuyAccount(fixtureAccount, contextAccount, options) {
-  const resolvedAccount = contextAccount ?? resolveAccount(options);
-  if (contextAccount === void 0 && fixtureAccount !== null && typeof fixtureAccount === "object" && !Array.isArray(fixtureAccount) && typeof fixtureAccount.operator === "string" && typeof fixtureAccount.account_id !== "string") {
-    const sandbox = resolvedAccount.sandbox;
+  if (hasAuthoredAccountIdentity(fixtureAccount)) {
+    if (hasUnresolvedContextReference(fixtureAccount)) return fixtureAccount;
+    if (typeof fixtureAccount.account_id === "string") return fixtureAccount;
+    const sandbox = contextAccount?.sandbox ?? resolveAccount(options).sandbox;
     return {
       ...fixtureAccount,
       ...sandbox !== void 0 && { sandbox }
     };
   }
-  return resolvedAccount;
+  return contextAccount ?? resolveAccount(options);
 }
 function resolveDiscoveryAccount(task, fixtureAccount, contextAccount, options) {
-  if (ACCOUNT_FREE_DISCOVERY_TASKS.has(task) && contextAccount === void 0 && hasUnresolvedContextReference(fixtureAccount))
-    return void 0;
+  if (ACCOUNT_FREE_DISCOVERY_TASKS.has(task) && hasUnresolvedContextReference(fixtureAccount)) return contextAccount;
   if (ACCOUNT_FREE_DISCOVERY_TASKS.has(task) && fixtureAccount === void 0 && contextAccount === void 0)
     return void 0;
-  if (contextAccount === void 0 && fixtureAccount && typeof fixtureAccount === "object" && "account_id" in fixtureAccount)
-    return fixtureAccount;
   return resolveMediaBuyAccount(fixtureAccount, contextAccount, options);
 }
 const OPERATION_SCOPED_CONTROLLER_SCENARIOS = /* @__PURE__ */ new Set([

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 = "15.7.1";
+export declare const RUNNER_CAPABILITY_VERSION = "15.8.0";
 /** 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 = "15.7.1";
+export declare const RUNNER_CAPABILITY_VERSION = "15.8.0";
 /** 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.d.mts

@@ -258,5 +258,27 @@ export declare function projectMediaBuyCreativesForDelivery<T>(request: T, wireM
 export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: 'canonical', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedSyncCreativeRequest<T, 'canonical'>;
 export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: 'legacy' | 'unknown', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedSyncCreativeRequest<T, 'legacy'>;
 export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: CreativeFormatWireMode, legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedSyncCreativeRequest<T, 'canonical'> | ProjectedSyncCreativeRequest<T, 'legacy'>;
+/** The direct canonical selector for a format option the seller did not declare. */
+export interface UndeclaredFormatOptionSelector {
+    format_kind: string;
+    params?: unknown;
+    /** Custom/schema-backed formats cannot retain identity in a direct selector. */
+    unrepresentable?: true;
+}
+/**
+ * Looks up a format option the SDK derived from a seller's legacy `format_ids`.
+ * Returns undefined for options the seller declared in its own `format_options[]`.
+ */
+export type UndeclaredFormatOptionLookup = (ref: FormatOptionReference, productId: string | undefined) => UndeclaredFormatOptionSelector | undefined;
+/**
+ * Canonical-wire counterpart to legacy downgrade for format options the seller
+ * never declared. AdCP 3.x products may carry only legacy `format_ids`; the SDK
+ * upgrades them for the buyer and mints the option ids itself. A seller only
+ * resolves `format_option_refs` against its own `format_options[]`, so a
+ * package selecting such options is sent as the equivalent `format_kind` +
+ * `params` selector, and creative pins to them are dropped. A selection that
+ * one direct selector cannot express fails closed before dispatch.
+ */
+export declare function projectUndeclaredFormatOptionSelectors<T>(request: T, operation: 'create_media_buy' | 'update_media_buy' | 'sync_creatives', lookup: UndeclaredFormatOptionLookup): T;
 export declare function resolveCreativeFormatWireMode(capabilities: unknown, negotiatedVersion?: string): CreativeFormatWireMode;
 export {};

package/dist/lib/v2/projection/creative-delivery.d.ts

@@ -258,5 +258,27 @@ export declare function projectMediaBuyCreativesForDelivery<T>(request: T, wireM
 export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: 'canonical', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedSyncCreativeRequest<T, 'canonical'>;
 export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: 'legacy' | 'unknown', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedSyncCreativeRequest<T, 'legacy'>;
 export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: CreativeFormatWireMode, legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedSyncCreativeRequest<T, 'canonical'> | ProjectedSyncCreativeRequest<T, 'legacy'>;
+/** The direct canonical selector for a format option the seller did not declare. */
+export interface UndeclaredFormatOptionSelector {
+    format_kind: string;
+    params?: unknown;
+    /** Custom/schema-backed formats cannot retain identity in a direct selector. */
+    unrepresentable?: true;
+}
+/**
+ * Looks up a format option the SDK derived from a seller's legacy `format_ids`.
+ * Returns undefined for options the seller declared in its own `format_options[]`.
+ */
+export type UndeclaredFormatOptionLookup = (ref: FormatOptionReference, productId: string | undefined) => UndeclaredFormatOptionSelector | undefined;
+/**
+ * Canonical-wire counterpart to legacy downgrade for format options the seller
+ * never declared. AdCP 3.x products may carry only legacy `format_ids`; the SDK
+ * upgrades them for the buyer and mints the option ids itself. A seller only
+ * resolves `format_option_refs` against its own `format_options[]`, so a
+ * package selecting such options is sent as the equivalent `format_kind` +
+ * `params` selector, and creative pins to them are dropped. A selection that
+ * one direct selector cannot express fails closed before dispatch.
+ */
+export declare function projectUndeclaredFormatOptionSelectors<T>(request: T, operation: 'create_media_buy' | 'update_media_buy' | 'sync_creatives', lookup: UndeclaredFormatOptionLookup): T;
 export declare function resolveCreativeFormatWireMode(capabilities: unknown, negotiatedVersion?: string): CreativeFormatWireMode;
 export {};

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

@@ -23,6 +23,7 @@ __export(creative_delivery_exports, {
   projectCreativeForDelivery: () => projectCreativeForDelivery,
   projectMediaBuyCreativesForDelivery: () => projectMediaBuyCreativesForDelivery,
   projectSyncCreativesForDelivery: () => projectSyncCreativesForDelivery,
+  projectUndeclaredFormatOptionSelectors: () => projectUndeclaredFormatOptionSelectors,
   resolveCreativeFormatWireMode: () => resolveCreativeFormatWireMode,
   stripLegacyCreativeIdentity: () => stripLegacyCreativeIdentity
 });
@@ -30,6 +31,7 @@ module.exports = __toCommonJS(creative_delivery_exports);
 var import_v1_to_v2 = require('./v1-to-v2.js');
 var import_v2_to_v1 = require('./v2-to-v1.js');
 var import_legacy_metadata = require('./legacy-metadata.js');
+var import_jcs = require('../../utils/jcs.js');
 function stripLegacyCreativeIdentity(value) {
   const legacyTokens = /* @__PURE__ */ new Set();
   const legacyUrlTokens = /* @__PURE__ */ new Set();
@@ -941,6 +943,95 @@ function projectSyncCreativesForDelivery(request, selectorContainers, wireMode =
   });
   return changed ? { ...requestRecord, creatives } : request;
 }
+function stripUndeclaredCreativeOptionRef(creativeValue, productId, operation, lookup) {
+  const creative = record(creativeValue);
+  const ref = creative ? optionReference(creative.format_option_ref) : void 0;
+  if (!creative || !ref) return creativeValue;
+  const selector = lookup(ref, productId);
+  if (!selector) return creativeValue;
+  if (selector.unrepresentable || creative.format_kind === "custom") {
+    throw new CreativeFormatProjectionError(
+      operation,
+      typeof creative.creative_id === "string" ? creative.creative_id : "(unknown)",
+      "the seller did not declare this format option and its schema identity cannot be expressed without a seller-declared format_option_ref"
+    );
+  }
+  const next = { ...creative };
+  delete next.format_option_ref;
+  return next;
+}
+function directSelectorForUndeclaredOptions(pkg, operation, lookup) {
+  const refs = Array.isArray(pkg.format_option_refs) ? pkg.format_option_refs.flatMap((value) => {
+    const ref = optionReference(value);
+    return ref ? [ref] : [];
+  }) : [];
+  const productId = typeof pkg.product_id === "string" ? pkg.product_id : void 0;
+  const selectors = refs.map((ref) => lookup(ref, productId));
+  if (!selectors.some((selector2) => selector2 !== void 0)) return pkg;
+  if (refs.length !== pkg.format_option_refs.length || selectors.some((selector2) => selector2?.unrepresentable)) {
+    throw new CreativeFormatProjectionError(
+      operation,
+      "(package selector)",
+      "the selected undeclared format options cannot be expressed as a direct selector; custom formats require a seller-declared format option"
+    );
+  }
+  const distinct = [
+    ...new Map(
+      selectors.map((selector2) => [
+        selector2 ? (0, import_jcs.canonicalize)({ format_kind: selector2.format_kind, params: selector2.params ?? null }) : "",
+        selector2
+      ])
+    ).values()
+  ];
+  const selector = distinct.length === 1 ? distinct[0] : void 0;
+  if (!selector || pkg.format_kind !== void 0 || pkg.params !== void 0) {
+    throw new CreativeFormatProjectionError(
+      operation,
+      "(package selector)",
+      "the seller did not declare the selected format options in its product format_options; select options that one format_kind + params selector can express"
+    );
+  }
+  const next = { ...pkg, format_kind: selector.format_kind };
+  delete next.format_option_refs;
+  if (selector.params !== void 0) next.params = structuredClone(selector.params);
+  return next;
+}
+function projectUndeclaredFormatOptionSelectors(request, operation, lookup) {
+  const requestRecord = record(request);
+  if (!requestRecord) return request;
+  let changed = false;
+  const next = { ...requestRecord };
+  for (const key of ["packages", "new_packages"]) {
+    const packages = requestRecord[key];
+    if (!Array.isArray(packages)) continue;
+    next[key] = packages.map((packageValue) => {
+      const pkg = record(packageValue);
+      if (!pkg) return packageValue;
+      const productId = typeof pkg.product_id === "string" ? pkg.product_id : void 0;
+      let projected = directSelectorForUndeclaredOptions(pkg, operation, lookup);
+      if (Array.isArray(pkg.creatives)) {
+        const creatives = pkg.creatives.map(
+          (creative) => stripUndeclaredCreativeOptionRef(creative, productId, operation, lookup)
+        );
+        if (creatives.some((creative, index) => creative !== pkg.creatives[index])) {
+          projected = { ...projected, creatives };
+        }
+      }
+      if (projected !== pkg) changed = true;
+      return projected;
+    });
+  }
+  if (Array.isArray(requestRecord.creatives)) {
+    const creatives = requestRecord.creatives.map(
+      (creative) => stripUndeclaredCreativeOptionRef(creative, void 0, operation, lookup)
+    );
+    if (creatives.some((creative, index) => creative !== requestRecord.creatives[index])) {
+      next.creatives = creatives;
+      changed = true;
+    }
+  }
+  return changed ? next : request;
+}
 function release(value) {
   if (typeof value !== "string") return void 0;
   const match = /^v?(\d+)\.(\d+)(?:\.|-|$)/.exec(value.trim());
@@ -1022,6 +1113,7 @@ function resolveCreativeFormatWireMode(capabilities, negotiatedVersion) {
   projectCreativeForDelivery,
   projectMediaBuyCreativesForDelivery,
   projectSyncCreativesForDelivery,
+  projectUndeclaredFormatOptionSelectors,
   resolveCreativeFormatWireMode,
   stripLegacyCreativeIdentity
 });

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

@@ -10,6 +10,7 @@ import {
   selectedFormatOptions,
   transferLegacyCreativeMetadata
 } from "./legacy-metadata.mjs";
+import { canonicalize as canonicalizeJson } from "../../utils/jcs.mjs";
 function stripLegacyCreativeIdentity(value) {
   const legacyTokens = /* @__PURE__ */ new Set();
   const legacyUrlTokens = /* @__PURE__ */ new Set();
@@ -921,6 +922,95 @@ function projectSyncCreativesForDelivery(request, selectorContainers, wireMode =
   });
   return changed ? { ...requestRecord, creatives } : request;
 }
+function stripUndeclaredCreativeOptionRef(creativeValue, productId, operation, lookup) {
+  const creative = record(creativeValue);
+  const ref = creative ? optionReference(creative.format_option_ref) : void 0;
+  if (!creative || !ref) return creativeValue;
+  const selector = lookup(ref, productId);
+  if (!selector) return creativeValue;
+  if (selector.unrepresentable || creative.format_kind === "custom") {
+    throw new CreativeFormatProjectionError(
+      operation,
+      typeof creative.creative_id === "string" ? creative.creative_id : "(unknown)",
+      "the seller did not declare this format option and its schema identity cannot be expressed without a seller-declared format_option_ref"
+    );
+  }
+  const next = { ...creative };
+  delete next.format_option_ref;
+  return next;
+}
+function directSelectorForUndeclaredOptions(pkg, operation, lookup) {
+  const refs = Array.isArray(pkg.format_option_refs) ? pkg.format_option_refs.flatMap((value) => {
+    const ref = optionReference(value);
+    return ref ? [ref] : [];
+  }) : [];
+  const productId = typeof pkg.product_id === "string" ? pkg.product_id : void 0;
+  const selectors = refs.map((ref) => lookup(ref, productId));
+  if (!selectors.some((selector2) => selector2 !== void 0)) return pkg;
+  if (refs.length !== pkg.format_option_refs.length || selectors.some((selector2) => selector2?.unrepresentable)) {
+    throw new CreativeFormatProjectionError(
+      operation,
+      "(package selector)",
+      "the selected undeclared format options cannot be expressed as a direct selector; custom formats require a seller-declared format option"
+    );
+  }
+  const distinct = [
+    ...new Map(
+      selectors.map((selector2) => [
+        selector2 ? canonicalizeJson({ format_kind: selector2.format_kind, params: selector2.params ?? null }) : "",
+        selector2
+      ])
+    ).values()
+  ];
+  const selector = distinct.length === 1 ? distinct[0] : void 0;
+  if (!selector || pkg.format_kind !== void 0 || pkg.params !== void 0) {
+    throw new CreativeFormatProjectionError(
+      operation,
+      "(package selector)",
+      "the seller did not declare the selected format options in its product format_options; select options that one format_kind + params selector can express"
+    );
+  }
+  const next = { ...pkg, format_kind: selector.format_kind };
+  delete next.format_option_refs;
+  if (selector.params !== void 0) next.params = structuredClone(selector.params);
+  return next;
+}
+function projectUndeclaredFormatOptionSelectors(request, operation, lookup) {
+  const requestRecord = record(request);
+  if (!requestRecord) return request;
+  let changed = false;
+  const next = { ...requestRecord };
+  for (const key of ["packages", "new_packages"]) {
+    const packages = requestRecord[key];
+    if (!Array.isArray(packages)) continue;
+    next[key] = packages.map((packageValue) => {
+      const pkg = record(packageValue);
+      if (!pkg) return packageValue;
+      const productId = typeof pkg.product_id === "string" ? pkg.product_id : void 0;
+      let projected = directSelectorForUndeclaredOptions(pkg, operation, lookup);
+      if (Array.isArray(pkg.creatives)) {
+        const creatives = pkg.creatives.map(
+          (creative) => stripUndeclaredCreativeOptionRef(creative, productId, operation, lookup)
+        );
+        if (creatives.some((creative, index) => creative !== pkg.creatives[index])) {
+          projected = { ...projected, creatives };
+        }
+      }
+      if (projected !== pkg) changed = true;
+      return projected;
+    });
+  }
+  if (Array.isArray(requestRecord.creatives)) {
+    const creatives = requestRecord.creatives.map(
+      (creative) => stripUndeclaredCreativeOptionRef(creative, void 0, operation, lookup)
+    );
+    if (creatives.some((creative, index) => creative !== requestRecord.creatives[index])) {
+      next.creatives = creatives;
+      changed = true;
+    }
+  }
+  return changed ? next : request;
+}
 function release(value) {
   if (typeof value !== "string") return void 0;
   const match = /^v?(\d+)\.(\d+)(?:\.|-|$)/.exec(value.trim());
@@ -1001,6 +1091,7 @@ export {
   projectCreativeForDelivery,
   projectMediaBuyCreativesForDelivery,
   projectSyncCreativesForDelivery,
+  projectUndeclaredFormatOptionSelectors,
   resolveCreativeFormatWireMode,
   stripLegacyCreativeIdentity
 };

package/dist/lib/v2/projection/legacy-metadata.d.mts

@@ -1,9 +1,9 @@
 import type { ProductFormatDeclaration } from '../../types/tools.generated.mjs';
 import type { V1FormatId, V2ProductFormatDeclaration } from './types.mjs';
 /**
- * SDK-private downgrade metadata held out-of-band. WeakMaps keep legacy
- * routing identifiers absent from canonical objects even under reflective
- * inspection while still allowing object-spread package authoring.
+ * SDK-private projection metadata held out-of-band. WeakMaps keep seller
+ * origin evidence and legacy routing identifiers absent from canonical objects
+ * even under reflective inspection while still allowing object-spread package authoring.
  */
 export type CanonicalFormatDeclaration = Omit<V2ProductFormatDeclaration, 'v1_format_ref'> & {
     v1_format_ref?: never;
@@ -12,6 +12,9 @@ type DeclarationWithMetadata = CanonicalFormatDeclaration;
 export type PackageSelectionMetadata = {
     format_option_refs?: readonly unknown[];
 };
+/** Keep seller-origin evidence private while canonical products pass through the cache. */
+export declare function rememberSellerDeclaredFormatOption(declaration: object, declared: boolean): void;
+export declare function sellerDeclaredFormatOption(declaration: object): boolean | undefined;
 export declare function concealLegacyFormatRefs(declaration: ProductFormatDeclaration | V2ProductFormatDeclaration | CanonicalFormatDeclaration): DeclarationWithMetadata;
 export declare function legacyFormatRefsForDeclaration(value: unknown): readonly V1FormatId[];
 export declare function selectedFormatOptions(value: unknown): readonly DeclarationWithMetadata[];

package/dist/lib/v2/projection/legacy-metadata.d.ts

@@ -1,9 +1,9 @@
 import type { ProductFormatDeclaration } from '../../types/tools.generated';
 import type { V1FormatId, V2ProductFormatDeclaration } from './types';
 /**
- * SDK-private downgrade metadata held out-of-band. WeakMaps keep legacy
- * routing identifiers absent from canonical objects even under reflective
- * inspection while still allowing object-spread package authoring.
+ * SDK-private projection metadata held out-of-band. WeakMaps keep seller
+ * origin evidence and legacy routing identifiers absent from canonical objects
+ * even under reflective inspection while still allowing object-spread package authoring.
  */
 export type CanonicalFormatDeclaration = Omit<V2ProductFormatDeclaration, 'v1_format_ref'> & {
     v1_format_ref?: never;
@@ -12,6 +12,9 @@ type DeclarationWithMetadata = CanonicalFormatDeclaration;
 export type PackageSelectionMetadata = {
     format_option_refs?: readonly unknown[];
 };
+/** Keep seller-origin evidence private while canonical products pass through the cache. */
+export declare function rememberSellerDeclaredFormatOption(declaration: object, declared: boolean): void;
+export declare function sellerDeclaredFormatOption(declaration: object): boolean | undefined;
 export declare function concealLegacyFormatRefs(declaration: ProductFormatDeclaration | V2ProductFormatDeclaration | CanonicalFormatDeclaration): DeclarationWithMetadata;
 export declare function legacyFormatRefsForDeclaration(value: unknown): readonly V1FormatId[];
 export declare function selectedFormatOptions(value: unknown): readonly DeclarationWithMetadata[];

package/dist/lib/v2/projection/legacy-metadata.js

@@ -21,17 +21,28 @@ __export(legacy_metadata_exports, {
   concealLegacyFormatRefs: () => concealLegacyFormatRefs,
   concealSelectedFormatOptions: () => concealSelectedFormatOptions,
   legacyFormatRefsForDeclaration: () => legacyFormatRefsForDeclaration,
+  rememberSellerDeclaredFormatOption: () => rememberSellerDeclaredFormatOption,
   selectedFormatOptions: () => selectedFormatOptions,
+  sellerDeclaredFormatOption: () => sellerDeclaredFormatOption,
   structuredCloneWithLegacyCreativeMetadata: () => structuredCloneWithLegacyCreativeMetadata,
   transferLegacyCreativeMetadata: () => transferLegacyCreativeMetadata
 });
 module.exports = __toCommonJS(legacy_metadata_exports);
 const legacyRefsByDeclaration = /* @__PURE__ */ new WeakMap();
 const selectedOptionsByRefs = /* @__PURE__ */ new WeakMap();
+const sellerDeclaredByDeclaration = /* @__PURE__ */ new WeakMap();
+function rememberSellerDeclaredFormatOption(declaration, declared) {
+  sellerDeclaredByDeclaration.set(declaration, declared);
+}
+function sellerDeclaredFormatOption(declaration) {
+  return sellerDeclaredByDeclaration.get(declaration);
+}
 function concealLegacyFormatRefs(declaration) {
   const { v1_format_ref: refs, ...canonical } = declaration;
   const existingHidden = legacyRefsByDeclaration.get(declaration);
   const refsToConceal = Array.isArray(existingHidden) && existingHidden.length > 0 ? existingHidden : refs;
+  const declared = sellerDeclaredByDeclaration.get(declaration);
+  if (declared !== void 0) sellerDeclaredByDeclaration.set(canonical, declared);
   if (Array.isArray(refsToConceal) && refsToConceal.length > 0) {
     legacyRefsByDeclaration.set(
       canonical,
@@ -62,11 +73,15 @@ function transferLegacyCreativeMetadata(source, target) {
   if (refs) legacyRefsByDeclaration.set(target, refs);
   const selected = selectedOptionsByRefs.get(source);
   if (selected) selectedOptionsByRefs.set(target, selected);
+  const declared = sellerDeclaredByDeclaration.get(source);
+  if (declared !== void 0) sellerDeclaredByDeclaration.set(target, declared);
 }
 function structuredCloneWithLegacyCreativeMetadata(value) {
   const clone = structuredClone(value);
   const visited = /* @__PURE__ */ new WeakMap();
   const snapshotMetadata = (source, target) => {
+    const declared = sellerDeclaredByDeclaration.get(source);
+    if (declared !== void 0) sellerDeclaredByDeclaration.set(target, declared);
     const refs = legacyRefsByDeclaration.get(source);
     if (refs) legacyRefsByDeclaration.set(target, structuredClone(refs));
     const selected = selectedOptionsByRefs.get(source);
@@ -105,7 +120,9 @@ function structuredCloneWithLegacyCreativeMetadata(value) {
   concealLegacyFormatRefs,
   concealSelectedFormatOptions,
   legacyFormatRefsForDeclaration,
+  rememberSellerDeclaredFormatOption,
   selectedFormatOptions,
+  sellerDeclaredFormatOption,
   structuredCloneWithLegacyCreativeMetadata,
   transferLegacyCreativeMetadata
 });

package/dist/lib/v2/projection/legacy-metadata.mjs

@@ -1,9 +1,18 @@
 const legacyRefsByDeclaration = /* @__PURE__ */ new WeakMap();
 const selectedOptionsByRefs = /* @__PURE__ */ new WeakMap();
+const sellerDeclaredByDeclaration = /* @__PURE__ */ new WeakMap();
+function rememberSellerDeclaredFormatOption(declaration, declared) {
+  sellerDeclaredByDeclaration.set(declaration, declared);
+}
+function sellerDeclaredFormatOption(declaration) {
+  return sellerDeclaredByDeclaration.get(declaration);
+}
 function concealLegacyFormatRefs(declaration) {
   const { v1_format_ref: refs, ...canonical } = declaration;
   const existingHidden = legacyRefsByDeclaration.get(declaration);
   const refsToConceal = Array.isArray(existingHidden) && existingHidden.length > 0 ? existingHidden : refs;
+  const declared = sellerDeclaredByDeclaration.get(declaration);
+  if (declared !== void 0) sellerDeclaredByDeclaration.set(canonical, declared);
   if (Array.isArray(refsToConceal) && refsToConceal.length > 0) {
     legacyRefsByDeclaration.set(
       canonical,
@@ -34,11 +43,15 @@ function transferLegacyCreativeMetadata(source, target) {
   if (refs) legacyRefsByDeclaration.set(target, refs);
   const selected = selectedOptionsByRefs.get(source);
   if (selected) selectedOptionsByRefs.set(target, selected);
+  const declared = sellerDeclaredByDeclaration.get(source);
+  if (declared !== void 0) sellerDeclaredByDeclaration.set(target, declared);
 }
 function structuredCloneWithLegacyCreativeMetadata(value) {
   const clone = structuredClone(value);
   const visited = /* @__PURE__ */ new WeakMap();
   const snapshotMetadata = (source, target) => {
+    const declared = sellerDeclaredByDeclaration.get(source);
+    if (declared !== void 0) sellerDeclaredByDeclaration.set(target, declared);
     const refs = legacyRefsByDeclaration.get(source);
     if (refs) legacyRefsByDeclaration.set(target, structuredClone(refs));
     const selected = selectedOptionsByRefs.get(source);
@@ -76,7 +89,9 @@ export {
   concealLegacyFormatRefs,
   concealSelectedFormatOptions,
   legacyFormatRefsForDeclaration,
+  rememberSellerDeclaredFormatOption,
   selectedFormatOptions,
+  sellerDeclaredFormatOption,
   structuredCloneWithLegacyCreativeMetadata,
   transferLegacyCreativeMetadata
 };

package/dist/lib/version.d.mts

@@ -1,7 +1,7 @@
 /**
  * AdCP SDK library version
  */
-export declare const LIBRARY_VERSION = "15.7.1";
+export declare const LIBRARY_VERSION = "15.8.0";
 /**
  * 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: "15.7.1";
+    readonly library: "15.8.0";
     readonly adcp: "3.2.3";
     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.1.19", "3.1.20", "3.1.21", "3.1.22", "3.1.23", "3.1.24", "3.2.1", "3.2", "3.2.2", "3.2.3"];
-    readonly generatedAt: "2026-10-10T00:48:09.224Z";
+    readonly generatedAt: "2026-10-11T12:51:13.665Z";
 };
 /**
  * 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 = "15.7.1";
+export declare const LIBRARY_VERSION = "15.8.0";
 /**
  * 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: "15.7.1";
+    readonly library: "15.8.0";
     readonly adcp: "3.2.3";
     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.1.19", "3.1.20", "3.1.21", "3.1.22", "3.1.23", "3.1.24", "3.2.1", "3.2", "3.2.2", "3.2.3"];
-    readonly generatedAt: "2026-10-10T00:48:09.224Z";
+    readonly generatedAt: "2026-10-11T12:51:13.665Z";
 };
 /**
  * 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 = "15.7.1";
+const LIBRARY_VERSION = "15.8.0";
 const ADCP_VERSION = "3.2.3";
 const ADCP_MAJOR_VERSION = 3;
 const COMPATIBLE_ADCP_VERSIONS = [
@@ -97,10 +97,10 @@ const COMPATIBLE_ADCP_VERSIONS = [
   "3.2.3"
 ];
 const VERSION_INFO = {
-  library: "15.7.1",
+  library: "15.8.0",
   adcp: "3.2.3",
   compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
-  generatedAt: "2026-10-10T00:48:09.224Z"
+  generatedAt: "2026-10-11T12:51:13.665Z"
 };
 function getAdcpVersion() {
   return ADCP_VERSION;

package/dist/lib/version.mjs

@@ -1,4 +1,4 @@
-const LIBRARY_VERSION = "15.7.1";
+const LIBRARY_VERSION = "15.8.0";
 const ADCP_VERSION = "3.2.3";
 const ADCP_MAJOR_VERSION = 3;
 const COMPATIBLE_ADCP_VERSIONS = [
@@ -64,10 +64,10 @@ const COMPATIBLE_ADCP_VERSIONS = [
   "3.2.3"
 ];
 const VERSION_INFO = {
-  library: "15.7.1",
+  library: "15.8.0",
   adcp: "3.2.3",
   compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
-  generatedAt: "2026-10-10T00:48:09.224Z"
+  generatedAt: "2026-10-11T12:51:13.665Z"
 };
 function getAdcpVersion() {
   return ADCP_VERSION;

package/docs/TYPE-SUMMARY.md

@@ -1,7 +1,7 @@
 # AdCP Type Summary
 
-> Generated at: 2026-10-10
-> @adcp/sdk v15.7.1
+> Generated at: 2026-10-11
+> @adcp/sdk v15.8.0
 
 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`.