@adcp/sdk 13.0.1 → 13.0.3

package/dist/lib/schemas-data/3.1/trusted-match/offer-price.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/trusted-match/offer-price.json",
+  "$id": "/schemas/3.1.20/trusted-match/offer-price.json",
   "title": "Offer Price",
   "description": "Lightweight price for a TMP offer. Used when the product supports variable pricing and the buyer specifies a price at match time.",
   "x-status": "experimental",

package/dist/lib/schemas-data/3.1/trusted-match/offer.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/trusted-match/offer.json",
+  "$id": "/schemas/3.1.20/trusted-match/offer.json",
   "title": "Offer",
   "description": "A buyer's response to a context match request. Generalizes package activation — a simple activation is an offer with just package_id. A rich response includes brand, price, summary, and optionally an inline creative manifest.",
   "x-status": "experimental",
@@ -11,15 +11,15 @@
       "description": "Package identifier from the media buy."
     },
     "seller_agent": {
-      "$ref": "/schemas/3.1.15/core/seller-agent-ref.json",
+      "$ref": "/schemas/3.1.20/core/seller-agent-ref.json",
       "description": "Optional echo of the package's seller agent from sync-time metadata. Provided for publisher-side observability so log pipelines can attribute offers to sellers without round-tripping to the media-buy store. Non-authoritative: the binding on the cached AvailablePackage is source of truth. When omitted, the router MAY stamp this field from its cached package→seller map."
     },
     "brand": {
-      "$ref": "/schemas/3.1.15/core/brand-ref.json",
+      "$ref": "/schemas/3.1.20/core/brand-ref.json",
       "description": "Brand for this offer. Required when the product allows dynamic brands (brand selected at match time rather than fixed on the package). For single-brand packages, the brand is already known from the media buy."
     },
     "price": {
-      "$ref": "/schemas/3.1.15/trusted-match/offer-price.json",
+      "$ref": "/schemas/3.1.20/trusted-match/offer-price.json",
       "description": "Price for this offer. Only present when the product supports variable pricing. For fixed-price packages, price is already set on the media buy."
     },
     "summary": {
@@ -27,7 +27,7 @@
       "description": "Buyer-generated description of the offer, for the publisher to judge relevance. E.g., '50% off Goldenfield mayo — recipe integration'. The publisher (or their AI assistant) uses this to decide whether the offer fits the context."
     },
     "creative_manifest": {
-      "$ref": "/schemas/3.1.15/core/creative-manifest.json",
+      "$ref": "/schemas/3.1.20/core/creative-manifest.json",
       "description": "Full creative details, inline. When present, the publisher has everything needed to render. Inline for small creatives (markdown, product card). For large creatives (VAST, video), the manifest references external assets via URLs."
     },
     "macros": {

package/dist/lib/schemas-data/3.1/trusted-match/provider-identity-match-response.json

@@ -1,15 +1,15 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/trusted-match/provider-identity-match-response.json",
+  "$id": "/schemas/3.1.20/trusted-match/provider-identity-match-response.json",
   "title": "Identity Match Response (Provider → Router)",
   "description": "Provider-to-router shape of the Identity Match response. An identity agent returns eligibility, the per-package serve-window throttle, and — when it mints one — an ordered list of TMPX chunks. Each chunk pairs a provider-local `slot_id` (declared at registration in `tmpx_slots`) with an opaque URL-safe `value`. Publisher-local destination names (ad-server macros, GAM key-values, VAST URL macros, DOOH play-log fields) MUST NOT appear on this hop; the router keys chunks under the emitting `provider_id` and the publisher's deployment configuration resolves `(provider_id, slot_id)` to the local destination (see publisher-tmpx-config.json). Router-hop fields (`tmpx_providers`, `tmpx`) MUST NOT appear on this shape — a router receiving them from a provider MUST reject the response. Envelope extension fields (`context`, `ext`) are intentionally omitted to prevent data leakage across the identity privacy boundary; they are forbidden by this schema.",
   "type": "object",
   "allOf": [
     {
-      "$ref": "/schemas/3.1.15/core/version-envelope.json"
+      "$ref": "/schemas/3.1.20/core/version-envelope.json"
     },
     {
-      "$ref": "/schemas/3.1.15/core/protocol-envelope.json"
+      "$ref": "/schemas/3.1.20/core/protocol-envelope.json"
     }
   ],
   "x-status": "experimental",
@@ -40,7 +40,7 @@
       "type": "array",
       "description": "Ordered TMPX chunk/value pairs this identity agent mints. Each entry names the provider-local `slot_id` the value fills (from the provider's registered `tmpx_slots` in provider-registration.json). Ordered-prefix invariant: a response that carries fewer chunks than the provider registered MUST emit an ordered prefix of the registered `tmpx_slots` — routers MUST NOT reorder or fill gaps. The router MUST validate this contract before forwarding: if the provider has no `tmpx_slots` registration, or if the chunk `slot_id` sequence is not an exact non-empty ordered prefix of the registered list (duplicate, reordered, sparse, or unregistered slot IDs), the router MUST drop that provider's chunks atomically and MUST NOT forward them into `tmpx_providers`. Cap of 2 chunks in v1 aligned with the GAM macro-slot budget; the cap MAY rise without a shape change. Omitted when this provider mints no TMPX (e.g. no eligible packages).",
       "items": {
-        "$ref": "/schemas/3.1.15/trusted-match/tmpx-chunk.json"
+        "$ref": "/schemas/3.1.20/trusted-match/tmpx-chunk.json"
       },
       "minItems": 1,
       "maxItems": 2

package/dist/lib/schemas-data/3.1/trusted-match/provider-registration.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/trusted-match/provider-registration.json",
+  "$id": "/schemas/3.1.20/trusted-match/provider-registration.json",
   "title": "TMP Provider Registration",
   "description": "Declares a TMP provider's endpoint, capabilities, and operational parameters. Used in router configuration (static YAML or dynamic API) and referenced by product-level provider entries. The publisher controls which providers participate in their ad decisioning. Endpoint URLs MUST be validated against SSRF, and dynamic registration endpoints MUST authenticate callers — see docs/trusted-match/specification#provider-registration-security.",
   "x-status": "experimental",
@@ -39,7 +39,7 @@
       "type": "array",
       "description": "Identity types this provider can resolve. The router selects Identity Match providers whose uid_types overlaps with any uid_type in the request's identities array. MUST be present and non-empty when identity_match is true.",
       "items": {
-        "$ref": "/schemas/3.1.15/enums/uid-type.json"
+        "$ref": "/schemas/3.1.20/enums/uid-type.json"
       },
       "minItems": 1
     },

package/dist/lib/schemas-data/3.1/trusted-match/publisher-tmpx-config.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/trusted-match/publisher-tmpx-config.json",
+  "$id": "/schemas/3.1.20/trusted-match/publisher-tmpx-config.json",
   "title": "Publisher TMPX Macro Mapping",
   "description": "Publisher-owned deployment configuration that maps each identity provider's TMPX slots to the ad-server macro names (or targeting keys, VAST substitutions, DOOH play-log fields) the publisher wants those chunks fired into on this surface. Mapping is authored by the publisher — the same operator who trafficks the corresponding ad-server line items — and never travels on the wire between identity provider and router. This keeps macro naming a deployment concern rather than a protocol identifier: providers emit chunks as `{slot_id, value}` pairs (see provider-identity-match-response.json), the router preserves ordering and slot IDs under the emitting `provider_id` (see identity-match-response.json), and this configuration resolves each `(provider_id, slot_id)` to a local destination on the way to the ad server. A publisher may map the same provider to different destinations across surfaces (GAM key-values vs. VAST macros vs. DOOH play-log fields) by carrying one instance of this configuration per surface.",
   "x-status": "experimental",

package/dist/lib/schemas-data/3.1/trusted-match/tmpx-chunk.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/trusted-match/tmpx-chunk.json",
+  "$id": "/schemas/3.1.20/trusted-match/tmpx-chunk.json",
   "title": "TMPX Chunk",
   "description": "A single provider TMPX chunk — the provider-local `slot_id` (declared at registration in `tmpx_slots`) and its opaque URL-safe `value`. Same shape on both hops of the Identity Match response: providers emit `tmpx_chunks[]` on the provider→router shape, the router forwards them under `tmpx_providers[provider_id].chunks[]` on the router→publisher shape. Publisher-local destination names never appear here — the publisher's deployment configuration resolves `(provider_id, slot_id)` → local destination via publisher-tmpx-config.json.",
   "x-status": "experimental",

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-02T12:36:49.079Z"
+  "synced_at": "2026-09-09T01:32:34.326Z"
 }

package/dist/lib/server/decisioning/capabilities.d.mts

@@ -454,11 +454,11 @@ export type BrandCapabilities = NonNullable<NonNullable<GetAdCPCapabilitiesRespo
  */
 export interface ComplianceTestingCapabilities {
     /**
-     * Scenarios this agent advertises support for. Wire enum is the
-     * canonical scenario enum, excluding `list_scenarios` because that
-     * is a discovery operation rather than a test capability. Framework
-     * defaults this from the adopter-supplied `complyTest` adapter set
-     * when omitted.
+     * Scenarios this agent advertises support for. The wire field is open to
+     * implementation-specific string values; canonical controller scenarios
+     * are recommendations, not an enum constraint. `list_scenarios` remains a
+     * discovery operation rather than a test capability. Framework defaults
+     * this from the adopter-supplied `complyTest` adapter set when omitted.
      */
     scenarios?: ReadonlyArray<_ComplianceTestingScenario>;
 }

package/dist/lib/server/decisioning/capabilities.d.ts

@@ -454,11 +454,11 @@ export type BrandCapabilities = NonNullable<NonNullable<GetAdCPCapabilitiesRespo
  */
 export interface ComplianceTestingCapabilities {
     /**
-     * Scenarios this agent advertises support for. Wire enum is the
-     * canonical scenario enum, excluding `list_scenarios` because that
-     * is a discovery operation rather than a test capability. Framework
-     * defaults this from the adopter-supplied `complyTest` adapter set
-     * when omitted.
+     * Scenarios this agent advertises support for. The wire field is open to
+     * implementation-specific string values; canonical controller scenarios
+     * are recommendations, not an enum constraint. `list_scenarios` remains a
+     * discovery operation rather than a test capability. Framework defaults
+     * this from the adopter-supplied `complyTest` adapter set when omitted.
      */
     scenarios?: ReadonlyArray<_ComplianceTestingScenario>;
 }

package/dist/lib/server/decisioning/capabilities.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/server/decisioning/capabilities.ts"],"sourcesContent":["/**\n * DecisioningCapabilities — single source of truth for `get_adcp_capabilities`\n * response and any admin UI surface a host wants to render.\n *\n * Adopters declare once. Framework wires the wire-protocol response;\n * adopters' admin tools (or the SDK CLI's `validate_platform_config`) consume\n * the same dataclass so there's no drift between \"what the agent says it\n * supports\" and \"what it actually does.\"\n *\n * Status: Preview / 6.0.\n *\n * @public\n */\n\nimport type { ZodSchema } from 'zod';\nimport type {\n  AdCPSpecialism,\n  MediaChannel,\n  PaymentTerms,\n  PricingModel,\n  GetAdCPCapabilitiesResponse,\n  PostalAreaSupport,\n} from '../../types/tools.generated';\nimport type { ProductMetricOptimizationLike } from '../../utils/capability-rollups';\nimport type { MediaBuyFeatures, AccountCapabilities, CreativeCapabilities } from '../../utils/capabilities';\nimport type { AdcpCapabilitiesOverrides } from '../create-adcp-server';\n\n/**\n * Pre-resolved alias for the wire `media_buy` block. Used as the projection\n * source for the five `media_buy.*` capability fields below so each typed\n * field references a single resolved shape instead of re-walking the\n * `GetAdCPCapabilitiesResponse` type graph independently. Without the\n * alias, `strict + skipLibCheck:false` adopters hit the TS instantiation\n * budget on the published `.d.ts` and tsc OOMs.\n */\ntype _MediaBuyCapabilities = NonNullable<GetAdCPCapabilitiesResponse['media_buy']>;\ntype _MediaBuyTargetingCapabilities = NonNullable<NonNullable<_MediaBuyCapabilities['execution']>['targeting']>;\ntype _ComplianceTestingScenario = NonNullable<\n  NonNullable<GetAdCPCapabilitiesResponse['compliance_testing']>['scenarios']\n>[number];\n\nexport interface DecisioningCapabilities<TConfig = unknown> {\n  /**\n   * Specialisms claimed; framework type-checks these against implemented platform\n   * interfaces. Arrays are `readonly` so adopters can declare with `as const`\n   * (load-bearing for the `RequiredPlatformsFor<S>` compile-time gate).\n   */\n  specialisms: readonly AdCPSpecialism[];\n\n  /**\n   * Creative agents this seller composes with. Framework fetches format catalogs\n   * from each (1h cache) and unions them on `list_creative_formats`. Self-hosting\n   * sellers point at their own `agent_url`; framework calls into their\n   * `CreativePlatform.listFormats()` locally instead of HTTP-fetching.\n   *\n   * `format_ids` filter (optional) subsets a single creative agent's catalog.\n   * Useful when a creative agent hosts 50 formats but this seller only accepts\n   * 10 of them. Filter scope is per-creative-agent: `[{ agent_url: A, format_ids: ['x'] }, { agent_url: B }]`\n   * means \"from A only format x; from B all formats.\"\n   *\n   * Omit for signals-only platforms (`signal-marketplace`, `signal-owned`) — they\n   * sell audience data access, not media inventory, and don't compose with creative agents.\n   */\n  creative_agents?: readonly CreativeAgentRef[];\n\n  /**\n   * Channels this platform sells.\n   *\n   * Omit for non-media-buy platforms — they don't sell ad inventory and have no\n   * channels to declare. Applies to signals (`signal-marketplace`, `signal-owned`),\n   * governance (`governance-spend-authority`, `governance-delivery-monitor`,\n   * `property-lists`, `collection-lists`, `content-standards`), creative-only\n   * (`creative-ad-server`, `creative-template`, `creative-generative`), and\n   * brand (`brand-rights`) platforms.\n   *\n   * **Required at runtime for media-buy platforms.** `validatePlatform` (called\n   * by `createAdcpServerFromPlatform`) throws `PlatformConfigError` when any\n   * `sales-*` specialism is claimed and this field is absent.\n   */\n  channels?: readonly MediaChannel[];\n\n  /**\n   * Pricing models this platform supports.\n   *\n   * Omit for non-media-buy platforms — they don't sell ad inventory and have no\n   * channel-level pricing to declare. For signals platforms specifically, pricing\n   * is declared per-signal in the signal descriptor's `pricing_options[]` instead.\n   * Same non-media-buy specialism set as `channels` above.\n   *\n   * **Required at runtime for media-buy platforms.** `validatePlatform` (called\n   * by `createAdcpServerFromPlatform`) throws `PlatformConfigError` when any\n   * `sales-*` specialism is claimed and this field is absent.\n   */\n  pricingModels?: readonly PricingModel[];\n\n  /** Targeting capabilities. Optional — framework infers reasonable defaults if omitted. */\n  targeting?: TargetingCapabilities;\n\n  /** Reporting capabilities. Optional — framework infers reasonable defaults if omitted. */\n  reporting?: ReportingCapabilities;\n\n  /**\n   * Audience-matching capabilities — projected onto\n   * `get_adcp_capabilities.media_buy.audience_targeting`. Required for\n   * audience-sync adopters (CRM-list adopters that accept hashed\n   * identifiers + UID types) so buyers know which identifier shapes\n   * the platform will match against and what minimum audience size /\n   * matching latency to expect. Omit when the platform doesn't accept\n   * external audience uploads.\n   *\n   * Wire spec: `core/get-adcp-capabilities-response.json#media_buy.audience_targeting`.\n   */\n  audience_targeting?: NonNullable<_MediaBuyCapabilities['audience_targeting']>;\n\n  /**\n   * Conversion-tracking capabilities — projected onto\n   * `get_adcp_capabilities.media_buy.conversion_tracking`. Required for\n   * adopters that accept conversion events via `sync_event_sources` /\n   * `log_event` so buyers know which event types, action sources,\n   * attribution windows, and identifier shapes the platform supports.\n   * Omit when the platform doesn't track conversions.\n   *\n   * Wire spec: `core/get-adcp-capabilities-response.json#media_buy.conversion_tracking`.\n   */\n  conversion_tracking?: NonNullable<_MediaBuyCapabilities['conversion_tracking']>;\n\n  /**\n   * Content-standards capabilities — projected onto\n   * `get_adcp_capabilities.media_buy.content_standards`. Required for\n   * adopters claiming the `content-standards` specialism so buyers know\n   * whether the platform runs local evaluation, which channels it\n   * covers, and whether it supports webhook artifact delivery. Omit\n   * when the platform doesn't ship content-standards artifacts.\n   *\n   * Wire spec: `core/get-adcp-capabilities-response.json#media_buy.content_standards`.\n   */\n  content_standards?: NonNullable<_MediaBuyCapabilities['content_standards']>;\n\n  /**\n   * Seller-level rollup of optimization metrics — projected onto\n   * `get_adcp_capabilities.media_buy.supported_optimization_metrics`.\n   * Added in AdCP 3.1 (adcp#4669). The array union of every product's\n   * `metric_optimization.supported_metrics`. Storyboard runners gate\n   * `metric_optimization`-using scenarios on this field; declaring it\n   * gives buyers an upfront signal of which optimization metrics the\n   * seller can compute against (clicks, views, completed_views, etc.).\n   *\n   * Adopters can compute the rollup from their catalog using the\n   * exported {@link rollupOptimizationMetricsFromProducts} helper —\n   * keeps the declaration in sync with what products actually offer.\n   * Empty arrays are normalized away and the wire field is omitted; use\n   * omission to mean \"no seller-level metric rollup advertised\".\n   *\n   * Wire spec: `core/get-adcp-capabilities-response.json#media_buy.supported_optimization_metrics`.\n   */\n  supported_optimization_metrics?: NonNullable<_MediaBuyCapabilities['supported_optimization_metrics']>;\n\n  /**\n   * Static product-metric summary used for capability rollups.\n   *\n   * When this is present and `supported_optimization_metrics` is omitted,\n   * the framework derives `media_buy.supported_optimization_metrics` as the\n   * sorted union of every product summary's\n   * `metric_optimization.supported_metrics`. Full AdCP `Product` objects work,\n   * but this field is not a general product-discovery surface; a lightweight\n   * startup summary with just the `metric_optimization` block is enough.\n   * Dynamic per-account catalogs should continue to pass an explicit\n   * `supported_optimization_metrics` override. If the derived union is empty,\n   * the framework omits `supported_optimization_metrics` from the wire\n   * capabilities response.\n   */\n  productCatalog?: ReadonlyArray<ProductMetricOptimizationLike>;\n\n  /**\n   * Frequency-cap support declaration — projected onto\n   * `get_adcp_capabilities.media_buy.frequency_capping`. Added in AdCP\n   * 3.1 (adcp#4670). Presence-only object with `supported_per_units` /\n   * `supported_window_units` sub-fields declaring which frequency-cap\n   * shapes the platform honors. Omit when the platform doesn't accept\n   * frequency caps at all; buyers will avoid the field on `pacing.*`.\n   *\n   * Wire spec: `core/get-adcp-capabilities-response.json#media_buy.frequency_capping`.\n   */\n  frequency_capping?: NonNullable<_MediaBuyCapabilities['frequency_capping']>;\n\n  /**\n   * Whether this seller commits to the proposal lifecycle on get_products.\n   * Projected onto `get_adcp_capabilities.media_buy.supports_proposals`.\n   * Direct-buy sellers should declare `false` so proposal-only compliance\n   * storyboards are skipped; sellers with a ProposalManager are auto-derived\n   * as `true` unless they override this explicitly.\n   */\n  supportsProposals?: boolean;\n\n  /**\n   * Brand-protocol capabilities. Projected onto the wire `brand` block of\n   * `get_adcp_capabilities` (`brand: { rights, right_types, available_uses,\n   * generation_providers, description }`). The framework auto-derives\n   * `rights: true` when `BrandRightsPlatform` is supplied; adopters\n   * declare the rest (right_types they license, RightUses they support,\n   * generation providers they issue credentials for).\n   *\n   * REQUIRED when claiming the `'brand-rights'` specialism — enforced at\n   * compile-time via `RequiredCapabilitiesFor<S>`.\n   */\n  brand?: BrandCapabilities;\n\n  /**\n   * Compliance-testing capabilities. The presence of this block declares\n   * the deployment supports deterministic state-machine testing via the\n   * `comply_test_controller` wire tool. Keep this block declared when using\n   * `createAdcpServerFromPlatform(..., { complyTest })`; the framework makes\n   * live principals byte-identical to a production seller that never wired the\n   * controller by hiding this block, filtering `tools/list`, and returning MCP\n   * method-not-found for direct live calls.\n   *\n   * When this block is present, `createAdcpServerFromPlatform` REQUIRES\n   * `opts.complyTest` (the `ComplyControllerConfig` adapter set) to be\n   * supplied — claiming the capability without implementing the\n   * controller is a `PlatformConfigError` at construction.\n   *\n   * Inversely, supplying `opts.complyTest` without declaring this\n   * capability is also caught — the framework derives `scenarios` from\n   * the declared force/simulate/seed adapters and emits the discovery\n   * field on `get_adcp_capabilities` automatically for sandbox/mock\n   * principals. Live principals do not see the block.\n   */\n  compliance_testing?: ComplianceTestingCapabilities;\n\n  /**\n   * Billing parties this platform supports. `'operator'` = retail-media model\n   * (Criteo, Amazon — operator pays the publisher and bills the brand).\n   * `'agent'` = pass-through model (buyer's agent settles directly with the\n   * platform). `'advertiser'` = seller invoices the advertiser directly,\n   * bypassing operator settlement (advertiser-direct sell-side platforms where\n   * the brand is the direct contractual counterparty). Defaults to `['agent']`\n   * when omitted. To express advertiser-direct billing per account, set\n   * `billing.invoicedTo` to a `BrandReference` (the framework maps any\n   * `BrandReference` to `'advertiser'` on the wire).\n   */\n  supportedBillings?: ReadonlyArray<'operator' | 'agent' | 'advertiser'>;\n\n  /**\n   * Payment terms this platform accepts on `sync_accounts.payment_terms`.\n   * Omit to leave terms validation to `accounts.upsert` (or to accept any\n   * schema-valid value). When present, the framework rejects unsupported\n   * requested terms with `PAYMENT_TERMS_NOT_SUPPORTED` before dispatching\n   * the account entry to the adopter.\n   */\n  supportedPaymentTerms?: ReadonlyArray<PaymentTerms>;\n\n  /**\n   * If true, this platform refuses transactions without an authenticated\n   * operator principal (operator-billed retail-media). Framework emits\n   * `AUTH_REQUIRED` envelope before dispatching to the platform.\n   */\n  requireOperatorAuth?: boolean;\n\n  /**\n   * Media-buy feature flags forwarded into `get_adcp_capabilities.media_buy.features`.\n   * Adopter values serve as the base; auto-derived `audience_targeting`,\n   * `conversion_tracking`, and `content_standards` booleans take precedence\n   * for those three keys (overlaid by the framework via the per-domain\n   * `media_buy` override on the inner createAdcpServer call). Use this to\n   * declare `inlineCreativeManagement` and `propertyListFiltering` directly\n   * from `definePlatform`; declare not-supported feature blocks (e.g.\n   * `inlineCreativeManagement: false`) so the conformance runner grades\n   * them `not_applicable` instead of `fail`.\n   *\n   * Resolves the `definePlatform` passthrough gap noted in adcp-client#2199.\n   */\n  features?: Partial<MediaBuyFeatures>;\n\n  /**\n   * Creative-protocol capabilities forwarded into `get_adcp_capabilities.creative`.\n   * Use to declare `supportsCompliance`, `hasCreativeLibrary`,\n   * `supportsGeneration`, and `supportsTransformation` from `definePlatform`.\n   * Adopters that don't run a provenance-verification pipeline should\n   * declare the relevant fields as `false` so creative storyboards gate\n   * cleanly.\n   *\n   * Resolves the `definePlatform` passthrough gap noted in adcp-client#2199.\n   */\n  creative?: Partial<CreativeCapabilities>;\n\n  /**\n   * Account capabilities forwarded into `get_adcp_capabilities.account` as a\n   * base layer. The framework's existing `requireOperatorAuth` and\n   * `supportedBillings` projections overlay on top via the per-domain\n   * `account` override, so explicit projections win on those keys.\n   * `authorizationEndpoint`, `defaultBilling`, `requiredForProducts`, and\n   * `sandbox` are pure adopter-driven additions exposed through this slot.\n   *\n   * Resolves the `definePlatform` passthrough gap noted in adcp-client#2199.\n   */\n  account?: Partial<AccountCapabilities>;\n\n  /**\n   * Deep-merge overrides applied to the wire `get_adcp_capabilities`\n   * response. Use this for fields that the top-level `DecisioningCapabilities`\n   * shape doesn't model — `media_buy.propagation_surfaces`,\n   * `media_buy.measurement_terms`, `signals.discovery_modes`, etc. The\n   * framework's per-domain projections (auto-derived `media_buy`, `brand`,\n   * `account`, `compliance_testing` blocks) are merged AFTER adopter\n   * overrides, so framework-derived values remain authoritative on the keys\n   * the projection engine handles.\n   *\n   * Mirrors `AdcpCapabilitiesConfig.overrides` on the lower-level\n   * `createAdcpServer` API. Resolves the `definePlatform` passthrough gap\n   * noted in adcp-client#2199.\n   */\n  overrides?: AdcpCapabilitiesOverrides;\n\n  /**\n   * Release-precision AdCP versions this platform supports (e.g. `[\"3.0\", \"3.1\"]`).\n   * Forwarded into `get_adcp_capabilities.adcp.supported_versions`. 3.1+\n   * sellers should declare here the same release-precision strings they\n   * emit in `adcp_version` on responses; 3.0-pinned sellers can omit.\n   *\n   * Resolves the same gap previously noted for `supported_versions` —\n   * was unreachable through `definePlatform` because\n   * `CreateAdcpServerFromPlatformOptions` omits `'capabilities'` from\n   * `AdcpServerConfig`. See adcp-client#2199.\n   */\n  supported_versions?: string[];\n\n  /**\n   * Platform-specific config. Strongly typed when the adopter uses the generic.\n   * Example: `class GAM extends DecisioningPlatform<{ networkId: string }>`.\n   */\n  config: TConfig;\n\n  /**\n   * Optional Zod schema for runtime validation of `config`. When provided,\n   * framework validates at platform construction time; missing or wrong-shaped\n   * config rejects the agent at boot rather than at first request.\n   */\n  configSchema?: ZodSchema<TConfig>;\n}\n\nexport interface CreativeAgentRef {\n  agent_url: string;\n  /** Human-readable label for this creative agent. */\n  name?: string;\n  /** Optional allowlist of `format_id.id` values from THIS agent's catalog. Omit to include all. */\n  format_ids?: string[];\n}\n\n/**\n * Targeting capabilities the platform supports in `create_media_buy`. Maps\n * to AdCP `GetAdcpCapabilitiesResponse.media_buy.execution.targeting`.\n *\n * Shape converged across two independently-evolved peer codebases (Scope3\n * `agentic-adapters`, Prebid `salesagent`). Per-geo-system flags rather than\n * coarse enums because the two implementations agreed: real platforms support\n * specific geo identifier formats (Nielsen DMA, Eurostat NUTS2, US ZIP+4), not\n * abstract \"metro\" / \"postal\" categories.\n */\nexport interface TargetingCapabilities {\n  geo_countries?: boolean;\n  geo_regions?: boolean;\n\n  /** Metro / DMA identifier systems. */\n  geo_metros?: {\n    nielsen_dma?: boolean;\n    uk_itl1?: boolean;\n    uk_itl2?: boolean;\n    eurostat_nuts2?: boolean;\n  };\n\n  /**\n   * Postal-code identifier systems.\n   *\n   * AdCP 3.1.0-rc.10 prefers country-keyed arrays, e.g.\n   * `{ US: ['zip'], GB: ['outward'] }`. Deprecated country-fused booleans\n   * such as `{ us_zip: true }` remain accepted for 3.x adopters; the\n   * framework projects both forms with `normalizePostalAreaSupport()` so old\n   * and new buyers can read the capability safely during the migration.\n   */\n  geo_postal_areas?: TargetingPostalAreaSupport;\n\n  /** Geographic-proximity targeting (radius / drive-time / arbitrary geometry). */\n  geo_proximity?: {\n    radius?: boolean;\n    travel_time?: boolean;\n    geometry?: boolean;\n    transport_modes?: ReadonlyArray<'walking' | 'cycling' | 'driving' | 'public_transport'>;\n  };\n\n  /** Age-restriction targeting; `verification_methods` enumerates the assurance levels accepted. */\n  age_restriction?: {\n    supported?: boolean;\n    verification_methods?: ReadonlyArray<\n      'facial_age_estimation' | 'id_document' | 'digital_id' | 'credit_card' | 'world_id'\n    >;\n  };\n\n  device_platform?: boolean;\n  device_type?: boolean;\n  language?: boolean;\n  audience_include?: boolean;\n  audience_exclude?: boolean;\n\n  /** Keyword-targeting match types accepted on positive-match terms. */\n  keyword_targets?: {\n    supported_match_types: ReadonlyArray<'broad' | 'phrase' | 'exact'>;\n  };\n\n  /** Negative-keyword match types accepted. */\n  negative_keywords?: {\n    supported_match_types: ReadonlyArray<'broad' | 'phrase' | 'exact'>;\n  };\n}\n\nexport type TargetingPostalAreaSupport = {\n  US?: readonly ('zip' | 'zip_plus_four')[];\n  GB?: readonly ('outward' | 'full')[];\n  CA?: readonly ('fsa' | 'full')[];\n  DE?: readonly 'plz'[];\n  CH?: readonly 'plz'[];\n  AT?: readonly 'plz'[];\n  FR?: readonly 'code_postal'[];\n  AU?: readonly 'postcode'[];\n  BR?: readonly 'cep'[];\n  IN?: readonly 'pin'[];\n  ZA?: readonly 'postal_code'[];\n  /** @deprecated Use `US: ['zip']`. */\n  us_zip?: boolean;\n  /** @deprecated Use `US: ['zip_plus_four']`. */\n  us_zip_plus_four?: boolean;\n  /** @deprecated Use `GB: ['outward']`. */\n  gb_outward?: boolean;\n  /** @deprecated Use `GB: ['full']`. */\n  gb_full?: boolean;\n  /** @deprecated Use `CA: ['fsa']`. */\n  ca_fsa?: boolean;\n  /** @deprecated Use `CA: ['full']`. */\n  ca_full?: boolean;\n  /** @deprecated Use `DE: ['plz']`. */\n  de_plz?: boolean;\n  /** @deprecated Use `FR: ['code_postal']`. */\n  fr_code_postal?: boolean;\n  /** @deprecated Use `AU: ['postcode']`. */\n  au_postcode?: boolean;\n  /** @deprecated Use `CH: ['plz']`. */\n  ch_plz?: boolean;\n  /** @deprecated Use `AT: ['plz']`. */\n  at_plz?: boolean;\n  [country: `${Uppercase<string>}`]:\n    | readonly (\n        | 'zip'\n        | 'zip_plus_four'\n        | 'outward'\n        | 'full'\n        | 'fsa'\n        | 'plz'\n        | 'code_postal'\n        | 'postcode'\n        | 'cep'\n        | 'pin'\n        | 'postal_code'\n        | 'custom'\n      )[]\n    | undefined;\n};\n\nconst LEGACY_POSTAL_SYSTEMS = {\n  us_zip: { country: 'US', system: 'zip' },\n  us_zip_plus_four: { country: 'US', system: 'zip_plus_four' },\n  gb_outward: { country: 'GB', system: 'outward' },\n  gb_full: { country: 'GB', system: 'full' },\n  ca_fsa: { country: 'CA', system: 'fsa' },\n  ca_full: { country: 'CA', system: 'full' },\n  de_plz: { country: 'DE', system: 'plz' },\n  fr_code_postal: { country: 'FR', system: 'code_postal' },\n  au_postcode: { country: 'AU', system: 'postcode' },\n  ch_plz: { country: 'CH', system: 'plz' },\n  at_plz: { country: 'AT', system: 'plz' },\n} as const;\n\nconst LEGACY_POSTAL_BY_COUNTRY_SYSTEM = new Map(\n  Object.entries(LEGACY_POSTAL_SYSTEMS).map(([legacy, { country, system }]) => [`${country}:${system}`, legacy])\n);\n\nconst POSTAL_SYSTEMS_BY_COUNTRY: Record<string, readonly string[]> = {\n  US: ['zip', 'zip_plus_four'],\n  GB: ['outward', 'full'],\n  CA: ['fsa', 'full'],\n  DE: ['plz'],\n  CH: ['plz'],\n  AT: ['plz'],\n  FR: ['code_postal'],\n  AU: ['postcode'],\n  BR: ['cep'],\n  IN: ['pin'],\n  ZA: ['postal_code'],\n};\n\nconst GENERIC_POSTAL_SYSTEMS = ['postal_code', 'custom'] as const;\nconst POSTAL_COUNTRY_KEY_PATTERN = /^[A-Z]{2}$/;\n\nfunction appendUnique(target: string[], value: string): void {\n  if (!target.includes(value)) target.push(value);\n}\n\nfunction assertSupportedPostalSystems(country: string, systems: readonly string[]): void {\n  const allowed = POSTAL_SYSTEMS_BY_COUNTRY[country] ?? GENERIC_POSTAL_SYSTEMS;\n  const invalid = systems.filter(system => !allowed.includes(system));\n  if (invalid.length > 0) {\n    throw new Error(\n      `Invalid geo_postal_areas support for ${country}: ${invalid.join(', ')}. ` +\n        `Supported systems are: ${allowed.join(', ')}.`\n    );\n  }\n}\n\n/**\n * Normalize postal-area capabilities across the AdCP 3.1.0-rc.10 migration.\n *\n * The wire schema now prefers `{ US: ['zip'] }` style country-local systems,\n * while the old `{ us_zip: true }` booleans stay deprecated but accepted\n * through 3.x. This helper is deliberately bidirectional:\n *\n * - legacy booleans add their country-keyed system;\n * - country-keyed systems backfill the matching legacy boolean when one exists;\n * - explicit unsupported legacy booleans are omitted unless the system is\n *   otherwise advertised.\n */\nexport function normalizePostalAreaSupport(input: TargetingPostalAreaSupport): PostalAreaSupport {\n  const normalized: Record<string, string[] | boolean> = {};\n\n  for (const [key, value] of Object.entries(input)) {\n    if (Array.isArray(value)) {\n      if (!POSTAL_COUNTRY_KEY_PATTERN.test(key)) {\n        throw new Error(\n          `Invalid geo_postal_areas key \"${key}\". Use an ISO 3166-1 alpha-2 country code or a deprecated legacy boolean alias.`\n        );\n      }\n      assertSupportedPostalSystems(key, value);\n      const systems = (normalized[key] = Array.isArray(normalized[key]) ? (normalized[key] as string[]) : []);\n      for (const system of value) appendUnique(systems, system);\n      continue;\n    }\n    if (value === true && key in LEGACY_POSTAL_SYSTEMS) {\n      const { country, system } = LEGACY_POSTAL_SYSTEMS[key as keyof typeof LEGACY_POSTAL_SYSTEMS];\n      const systems = (normalized[country] = Array.isArray(normalized[country])\n        ? (normalized[country] as string[])\n        : []);\n      appendUnique(systems, system);\n      continue;\n    }\n    if (value === true) {\n      throw new Error(\n        `Invalid geo_postal_areas legacy alias \"${key}\". Use an ISO 3166-1 alpha-2 country key with supported postal systems.`\n      );\n    }\n  }\n\n  for (const [country, value] of Object.entries(normalized)) {\n    if (!Array.isArray(value)) continue;\n    for (const system of value) {\n      const legacy = LEGACY_POSTAL_BY_COUNTRY_SYSTEM.get(`${country}:${system}`);\n      if (legacy) normalized[legacy] = true;\n    }\n  }\n\n  return normalized as PostalAreaSupport;\n}\n\nexport function normalizeTargetingCapabilities(input: TargetingCapabilities): _MediaBuyTargetingCapabilities {\n  return {\n    ...input,\n    ...(input.geo_postal_areas && { geo_postal_areas: normalizePostalAreaSupport(input.geo_postal_areas) }),\n  } as _MediaBuyTargetingCapabilities;\n}\n\n/**\n * Reporting capabilities the platform supports in `get_media_buy_delivery`.\n *\n * `availableDimensions` is the breakdown axes the platform can group\n * delivery rows by. Vocabulary converged across Scope3 and Prebid.\n */\nexport interface ReportingCapabilities {\n  frequencies: ReadonlyArray<'hourly' | 'daily' | 'weekly'>;\n  expected_delay_minutes: number;\n  timezone: string;\n  metrics: string[];\n  date_range_support: 'date_range' | 'fixed_only';\n  supports_webhooks: boolean;\n  availableDimensions?: ReadonlyArray<\n    'geo' | 'device_type' | 'device_platform' | 'audience' | 'placement' | 'creative' | 'keyword' | 'catalog_item'\n  >;\n}\n\n/**\n * Brand-protocol capabilities — projected onto the wire `brand` block of\n * `get_adcp_capabilities` via the framework's `overrides.brand` deep-merge\n * seam. Adopters who also implement `BrandRightsPlatform` get\n * `rights: true` auto-derived; the other four fields (`right_types`,\n * `available_uses`, `generation_providers`, `description`) are\n * adopter-declared.\n *\n * Wire spec: `protocol/get-adcp-capabilities-response.json#brand`.\n */\nexport type BrandCapabilities = NonNullable<NonNullable<GetAdCPCapabilitiesResponse['brand']>>;\n\n/**\n * Compliance-testing capabilities — projected onto the wire-side\n * `compliance_testing` block of `get_adcp_capabilities` so buyers and\n * conformance harnesses can discover which `comply_test_controller`\n * scenarios the agent supports.\n *\n * Wire spec: `core/get-adcp-capabilities-response.json#compliance_testing`.\n *\n * The `scenarios` array MUST be non-empty when this block is declared\n * (per the spec). `'list_scenarios'` is implicit — adopters don't need\n * to enumerate it.\n */\nexport interface ComplianceTestingCapabilities {\n  /**\n   * Scenarios this agent advertises support for. Wire enum is the\n   * canonical scenario enum, excluding `list_scenarios` because that\n   * is a discovery operation rather than a test capability. Framework\n   * defaults this from the adopter-supplied `complyTest` adapter set\n   * when omitted.\n   */\n  scenarios?: ReadonlyArray<_ComplianceTestingScenario>;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../src/lib/server/decisioning/capabilities.ts"],"sourcesContent":["/**\n * DecisioningCapabilities — single source of truth for `get_adcp_capabilities`\n * response and any admin UI surface a host wants to render.\n *\n * Adopters declare once. Framework wires the wire-protocol response;\n * adopters' admin tools (or the SDK CLI's `validate_platform_config`) consume\n * the same dataclass so there's no drift between \"what the agent says it\n * supports\" and \"what it actually does.\"\n *\n * Status: Preview / 6.0.\n *\n * @public\n */\n\nimport type { ZodSchema } from 'zod';\nimport type {\n  AdCPSpecialism,\n  MediaChannel,\n  PaymentTerms,\n  PricingModel,\n  GetAdCPCapabilitiesResponse,\n  PostalAreaSupport,\n} from '../../types/tools.generated';\nimport type { ProductMetricOptimizationLike } from '../../utils/capability-rollups';\nimport type { MediaBuyFeatures, AccountCapabilities, CreativeCapabilities } from '../../utils/capabilities';\nimport type { AdcpCapabilitiesOverrides } from '../create-adcp-server';\n\n/**\n * Pre-resolved alias for the wire `media_buy` block. Used as the projection\n * source for the five `media_buy.*` capability fields below so each typed\n * field references a single resolved shape instead of re-walking the\n * `GetAdCPCapabilitiesResponse` type graph independently. Without the\n * alias, `strict + skipLibCheck:false` adopters hit the TS instantiation\n * budget on the published `.d.ts` and tsc OOMs.\n */\ntype _MediaBuyCapabilities = NonNullable<GetAdCPCapabilitiesResponse['media_buy']>;\ntype _MediaBuyTargetingCapabilities = NonNullable<NonNullable<_MediaBuyCapabilities['execution']>['targeting']>;\ntype _ComplianceTestingScenario = NonNullable<\n  NonNullable<GetAdCPCapabilitiesResponse['compliance_testing']>['scenarios']\n>[number];\n\nexport interface DecisioningCapabilities<TConfig = unknown> {\n  /**\n   * Specialisms claimed; framework type-checks these against implemented platform\n   * interfaces. Arrays are `readonly` so adopters can declare with `as const`\n   * (load-bearing for the `RequiredPlatformsFor<S>` compile-time gate).\n   */\n  specialisms: readonly AdCPSpecialism[];\n\n  /**\n   * Creative agents this seller composes with. Framework fetches format catalogs\n   * from each (1h cache) and unions them on `list_creative_formats`. Self-hosting\n   * sellers point at their own `agent_url`; framework calls into their\n   * `CreativePlatform.listFormats()` locally instead of HTTP-fetching.\n   *\n   * `format_ids` filter (optional) subsets a single creative agent's catalog.\n   * Useful when a creative agent hosts 50 formats but this seller only accepts\n   * 10 of them. Filter scope is per-creative-agent: `[{ agent_url: A, format_ids: ['x'] }, { agent_url: B }]`\n   * means \"from A only format x; from B all formats.\"\n   *\n   * Omit for signals-only platforms (`signal-marketplace`, `signal-owned`) — they\n   * sell audience data access, not media inventory, and don't compose with creative agents.\n   */\n  creative_agents?: readonly CreativeAgentRef[];\n\n  /**\n   * Channels this platform sells.\n   *\n   * Omit for non-media-buy platforms — they don't sell ad inventory and have no\n   * channels to declare. Applies to signals (`signal-marketplace`, `signal-owned`),\n   * governance (`governance-spend-authority`, `governance-delivery-monitor`,\n   * `property-lists`, `collection-lists`, `content-standards`), creative-only\n   * (`creative-ad-server`, `creative-template`, `creative-generative`), and\n   * brand (`brand-rights`) platforms.\n   *\n   * **Required at runtime for media-buy platforms.** `validatePlatform` (called\n   * by `createAdcpServerFromPlatform`) throws `PlatformConfigError` when any\n   * `sales-*` specialism is claimed and this field is absent.\n   */\n  channels?: readonly MediaChannel[];\n\n  /**\n   * Pricing models this platform supports.\n   *\n   * Omit for non-media-buy platforms — they don't sell ad inventory and have no\n   * channel-level pricing to declare. For signals platforms specifically, pricing\n   * is declared per-signal in the signal descriptor's `pricing_options[]` instead.\n   * Same non-media-buy specialism set as `channels` above.\n   *\n   * **Required at runtime for media-buy platforms.** `validatePlatform` (called\n   * by `createAdcpServerFromPlatform`) throws `PlatformConfigError` when any\n   * `sales-*` specialism is claimed and this field is absent.\n   */\n  pricingModels?: readonly PricingModel[];\n\n  /** Targeting capabilities. Optional — framework infers reasonable defaults if omitted. */\n  targeting?: TargetingCapabilities;\n\n  /** Reporting capabilities. Optional — framework infers reasonable defaults if omitted. */\n  reporting?: ReportingCapabilities;\n\n  /**\n   * Audience-matching capabilities — projected onto\n   * `get_adcp_capabilities.media_buy.audience_targeting`. Required for\n   * audience-sync adopters (CRM-list adopters that accept hashed\n   * identifiers + UID types) so buyers know which identifier shapes\n   * the platform will match against and what minimum audience size /\n   * matching latency to expect. Omit when the platform doesn't accept\n   * external audience uploads.\n   *\n   * Wire spec: `core/get-adcp-capabilities-response.json#media_buy.audience_targeting`.\n   */\n  audience_targeting?: NonNullable<_MediaBuyCapabilities['audience_targeting']>;\n\n  /**\n   * Conversion-tracking capabilities — projected onto\n   * `get_adcp_capabilities.media_buy.conversion_tracking`. Required for\n   * adopters that accept conversion events via `sync_event_sources` /\n   * `log_event` so buyers know which event types, action sources,\n   * attribution windows, and identifier shapes the platform supports.\n   * Omit when the platform doesn't track conversions.\n   *\n   * Wire spec: `core/get-adcp-capabilities-response.json#media_buy.conversion_tracking`.\n   */\n  conversion_tracking?: NonNullable<_MediaBuyCapabilities['conversion_tracking']>;\n\n  /**\n   * Content-standards capabilities — projected onto\n   * `get_adcp_capabilities.media_buy.content_standards`. Required for\n   * adopters claiming the `content-standards` specialism so buyers know\n   * whether the platform runs local evaluation, which channels it\n   * covers, and whether it supports webhook artifact delivery. Omit\n   * when the platform doesn't ship content-standards artifacts.\n   *\n   * Wire spec: `core/get-adcp-capabilities-response.json#media_buy.content_standards`.\n   */\n  content_standards?: NonNullable<_MediaBuyCapabilities['content_standards']>;\n\n  /**\n   * Seller-level rollup of optimization metrics — projected onto\n   * `get_adcp_capabilities.media_buy.supported_optimization_metrics`.\n   * Added in AdCP 3.1 (adcp#4669). The array union of every product's\n   * `metric_optimization.supported_metrics`. Storyboard runners gate\n   * `metric_optimization`-using scenarios on this field; declaring it\n   * gives buyers an upfront signal of which optimization metrics the\n   * seller can compute against (clicks, views, completed_views, etc.).\n   *\n   * Adopters can compute the rollup from their catalog using the\n   * exported {@link rollupOptimizationMetricsFromProducts} helper —\n   * keeps the declaration in sync with what products actually offer.\n   * Empty arrays are normalized away and the wire field is omitted; use\n   * omission to mean \"no seller-level metric rollup advertised\".\n   *\n   * Wire spec: `core/get-adcp-capabilities-response.json#media_buy.supported_optimization_metrics`.\n   */\n  supported_optimization_metrics?: NonNullable<_MediaBuyCapabilities['supported_optimization_metrics']>;\n\n  /**\n   * Static product-metric summary used for capability rollups.\n   *\n   * When this is present and `supported_optimization_metrics` is omitted,\n   * the framework derives `media_buy.supported_optimization_metrics` as the\n   * sorted union of every product summary's\n   * `metric_optimization.supported_metrics`. Full AdCP `Product` objects work,\n   * but this field is not a general product-discovery surface; a lightweight\n   * startup summary with just the `metric_optimization` block is enough.\n   * Dynamic per-account catalogs should continue to pass an explicit\n   * `supported_optimization_metrics` override. If the derived union is empty,\n   * the framework omits `supported_optimization_metrics` from the wire\n   * capabilities response.\n   */\n  productCatalog?: ReadonlyArray<ProductMetricOptimizationLike>;\n\n  /**\n   * Frequency-cap support declaration — projected onto\n   * `get_adcp_capabilities.media_buy.frequency_capping`. Added in AdCP\n   * 3.1 (adcp#4670). Presence-only object with `supported_per_units` /\n   * `supported_window_units` sub-fields declaring which frequency-cap\n   * shapes the platform honors. Omit when the platform doesn't accept\n   * frequency caps at all; buyers will avoid the field on `pacing.*`.\n   *\n   * Wire spec: `core/get-adcp-capabilities-response.json#media_buy.frequency_capping`.\n   */\n  frequency_capping?: NonNullable<_MediaBuyCapabilities['frequency_capping']>;\n\n  /**\n   * Whether this seller commits to the proposal lifecycle on get_products.\n   * Projected onto `get_adcp_capabilities.media_buy.supports_proposals`.\n   * Direct-buy sellers should declare `false` so proposal-only compliance\n   * storyboards are skipped; sellers with a ProposalManager are auto-derived\n   * as `true` unless they override this explicitly.\n   */\n  supportsProposals?: boolean;\n\n  /**\n   * Brand-protocol capabilities. Projected onto the wire `brand` block of\n   * `get_adcp_capabilities` (`brand: { rights, right_types, available_uses,\n   * generation_providers, description }`). The framework auto-derives\n   * `rights: true` when `BrandRightsPlatform` is supplied; adopters\n   * declare the rest (right_types they license, RightUses they support,\n   * generation providers they issue credentials for).\n   *\n   * REQUIRED when claiming the `'brand-rights'` specialism — enforced at\n   * compile-time via `RequiredCapabilitiesFor<S>`.\n   */\n  brand?: BrandCapabilities;\n\n  /**\n   * Compliance-testing capabilities. The presence of this block declares\n   * the deployment supports deterministic state-machine testing via the\n   * `comply_test_controller` wire tool. Keep this block declared when using\n   * `createAdcpServerFromPlatform(..., { complyTest })`; the framework makes\n   * live principals byte-identical to a production seller that never wired the\n   * controller by hiding this block, filtering `tools/list`, and returning MCP\n   * method-not-found for direct live calls.\n   *\n   * When this block is present, `createAdcpServerFromPlatform` REQUIRES\n   * `opts.complyTest` (the `ComplyControllerConfig` adapter set) to be\n   * supplied — claiming the capability without implementing the\n   * controller is a `PlatformConfigError` at construction.\n   *\n   * Inversely, supplying `opts.complyTest` without declaring this\n   * capability is also caught — the framework derives `scenarios` from\n   * the declared force/simulate/seed adapters and emits the discovery\n   * field on `get_adcp_capabilities` automatically for sandbox/mock\n   * principals. Live principals do not see the block.\n   */\n  compliance_testing?: ComplianceTestingCapabilities;\n\n  /**\n   * Billing parties this platform supports. `'operator'` = retail-media model\n   * (Criteo, Amazon — operator pays the publisher and bills the brand).\n   * `'agent'` = pass-through model (buyer's agent settles directly with the\n   * platform). `'advertiser'` = seller invoices the advertiser directly,\n   * bypassing operator settlement (advertiser-direct sell-side platforms where\n   * the brand is the direct contractual counterparty). Defaults to `['agent']`\n   * when omitted. To express advertiser-direct billing per account, set\n   * `billing.invoicedTo` to a `BrandReference` (the framework maps any\n   * `BrandReference` to `'advertiser'` on the wire).\n   */\n  supportedBillings?: ReadonlyArray<'operator' | 'agent' | 'advertiser'>;\n\n  /**\n   * Payment terms this platform accepts on `sync_accounts.payment_terms`.\n   * Omit to leave terms validation to `accounts.upsert` (or to accept any\n   * schema-valid value). When present, the framework rejects unsupported\n   * requested terms with `PAYMENT_TERMS_NOT_SUPPORTED` before dispatching\n   * the account entry to the adopter.\n   */\n  supportedPaymentTerms?: ReadonlyArray<PaymentTerms>;\n\n  /**\n   * If true, this platform refuses transactions without an authenticated\n   * operator principal (operator-billed retail-media). Framework emits\n   * `AUTH_REQUIRED` envelope before dispatching to the platform.\n   */\n  requireOperatorAuth?: boolean;\n\n  /**\n   * Media-buy feature flags forwarded into `get_adcp_capabilities.media_buy.features`.\n   * Adopter values serve as the base; auto-derived `audience_targeting`,\n   * `conversion_tracking`, and `content_standards` booleans take precedence\n   * for those three keys (overlaid by the framework via the per-domain\n   * `media_buy` override on the inner createAdcpServer call). Use this to\n   * declare `inlineCreativeManagement` and `propertyListFiltering` directly\n   * from `definePlatform`; declare not-supported feature blocks (e.g.\n   * `inlineCreativeManagement: false`) so the conformance runner grades\n   * them `not_applicable` instead of `fail`.\n   *\n   * Resolves the `definePlatform` passthrough gap noted in adcp-client#2199.\n   */\n  features?: Partial<MediaBuyFeatures>;\n\n  /**\n   * Creative-protocol capabilities forwarded into `get_adcp_capabilities.creative`.\n   * Use to declare `supportsCompliance`, `hasCreativeLibrary`,\n   * `supportsGeneration`, and `supportsTransformation` from `definePlatform`.\n   * Adopters that don't run a provenance-verification pipeline should\n   * declare the relevant fields as `false` so creative storyboards gate\n   * cleanly.\n   *\n   * Resolves the `definePlatform` passthrough gap noted in adcp-client#2199.\n   */\n  creative?: Partial<CreativeCapabilities>;\n\n  /**\n   * Account capabilities forwarded into `get_adcp_capabilities.account` as a\n   * base layer. The framework's existing `requireOperatorAuth` and\n   * `supportedBillings` projections overlay on top via the per-domain\n   * `account` override, so explicit projections win on those keys.\n   * `authorizationEndpoint`, `defaultBilling`, `requiredForProducts`, and\n   * `sandbox` are pure adopter-driven additions exposed through this slot.\n   *\n   * Resolves the `definePlatform` passthrough gap noted in adcp-client#2199.\n   */\n  account?: Partial<AccountCapabilities>;\n\n  /**\n   * Deep-merge overrides applied to the wire `get_adcp_capabilities`\n   * response. Use this for fields that the top-level `DecisioningCapabilities`\n   * shape doesn't model — `media_buy.propagation_surfaces`,\n   * `media_buy.measurement_terms`, `signals.discovery_modes`, etc. The\n   * framework's per-domain projections (auto-derived `media_buy`, `brand`,\n   * `account`, `compliance_testing` blocks) are merged AFTER adopter\n   * overrides, so framework-derived values remain authoritative on the keys\n   * the projection engine handles.\n   *\n   * Mirrors `AdcpCapabilitiesConfig.overrides` on the lower-level\n   * `createAdcpServer` API. Resolves the `definePlatform` passthrough gap\n   * noted in adcp-client#2199.\n   */\n  overrides?: AdcpCapabilitiesOverrides;\n\n  /**\n   * Release-precision AdCP versions this platform supports (e.g. `[\"3.0\", \"3.1\"]`).\n   * Forwarded into `get_adcp_capabilities.adcp.supported_versions`. 3.1+\n   * sellers should declare here the same release-precision strings they\n   * emit in `adcp_version` on responses; 3.0-pinned sellers can omit.\n   *\n   * Resolves the same gap previously noted for `supported_versions` —\n   * was unreachable through `definePlatform` because\n   * `CreateAdcpServerFromPlatformOptions` omits `'capabilities'` from\n   * `AdcpServerConfig`. See adcp-client#2199.\n   */\n  supported_versions?: string[];\n\n  /**\n   * Platform-specific config. Strongly typed when the adopter uses the generic.\n   * Example: `class GAM extends DecisioningPlatform<{ networkId: string }>`.\n   */\n  config: TConfig;\n\n  /**\n   * Optional Zod schema for runtime validation of `config`. When provided,\n   * framework validates at platform construction time; missing or wrong-shaped\n   * config rejects the agent at boot rather than at first request.\n   */\n  configSchema?: ZodSchema<TConfig>;\n}\n\nexport interface CreativeAgentRef {\n  agent_url: string;\n  /** Human-readable label for this creative agent. */\n  name?: string;\n  /** Optional allowlist of `format_id.id` values from THIS agent's catalog. Omit to include all. */\n  format_ids?: string[];\n}\n\n/**\n * Targeting capabilities the platform supports in `create_media_buy`. Maps\n * to AdCP `GetAdcpCapabilitiesResponse.media_buy.execution.targeting`.\n *\n * Shape converged across two independently-evolved peer codebases (Scope3\n * `agentic-adapters`, Prebid `salesagent`). Per-geo-system flags rather than\n * coarse enums because the two implementations agreed: real platforms support\n * specific geo identifier formats (Nielsen DMA, Eurostat NUTS2, US ZIP+4), not\n * abstract \"metro\" / \"postal\" categories.\n */\nexport interface TargetingCapabilities {\n  geo_countries?: boolean;\n  geo_regions?: boolean;\n\n  /** Metro / DMA identifier systems. */\n  geo_metros?: {\n    nielsen_dma?: boolean;\n    uk_itl1?: boolean;\n    uk_itl2?: boolean;\n    eurostat_nuts2?: boolean;\n  };\n\n  /**\n   * Postal-code identifier systems.\n   *\n   * AdCP 3.1.0-rc.10 prefers country-keyed arrays, e.g.\n   * `{ US: ['zip'], GB: ['outward'] }`. Deprecated country-fused booleans\n   * such as `{ us_zip: true }` remain accepted for 3.x adopters; the\n   * framework projects both forms with `normalizePostalAreaSupport()` so old\n   * and new buyers can read the capability safely during the migration.\n   */\n  geo_postal_areas?: TargetingPostalAreaSupport;\n\n  /** Geographic-proximity targeting (radius / drive-time / arbitrary geometry). */\n  geo_proximity?: {\n    radius?: boolean;\n    travel_time?: boolean;\n    geometry?: boolean;\n    transport_modes?: ReadonlyArray<'walking' | 'cycling' | 'driving' | 'public_transport'>;\n  };\n\n  /** Age-restriction targeting; `verification_methods` enumerates the assurance levels accepted. */\n  age_restriction?: {\n    supported?: boolean;\n    verification_methods?: ReadonlyArray<\n      'facial_age_estimation' | 'id_document' | 'digital_id' | 'credit_card' | 'world_id'\n    >;\n  };\n\n  device_platform?: boolean;\n  device_type?: boolean;\n  language?: boolean;\n  audience_include?: boolean;\n  audience_exclude?: boolean;\n\n  /** Keyword-targeting match types accepted on positive-match terms. */\n  keyword_targets?: {\n    supported_match_types: ReadonlyArray<'broad' | 'phrase' | 'exact'>;\n  };\n\n  /** Negative-keyword match types accepted. */\n  negative_keywords?: {\n    supported_match_types: ReadonlyArray<'broad' | 'phrase' | 'exact'>;\n  };\n}\n\nexport type TargetingPostalAreaSupport = {\n  US?: readonly ('zip' | 'zip_plus_four')[];\n  GB?: readonly ('outward' | 'full')[];\n  CA?: readonly ('fsa' | 'full')[];\n  DE?: readonly 'plz'[];\n  CH?: readonly 'plz'[];\n  AT?: readonly 'plz'[];\n  FR?: readonly 'code_postal'[];\n  AU?: readonly 'postcode'[];\n  BR?: readonly 'cep'[];\n  IN?: readonly 'pin'[];\n  ZA?: readonly 'postal_code'[];\n  /** @deprecated Use `US: ['zip']`. */\n  us_zip?: boolean;\n  /** @deprecated Use `US: ['zip_plus_four']`. */\n  us_zip_plus_four?: boolean;\n  /** @deprecated Use `GB: ['outward']`. */\n  gb_outward?: boolean;\n  /** @deprecated Use `GB: ['full']`. */\n  gb_full?: boolean;\n  /** @deprecated Use `CA: ['fsa']`. */\n  ca_fsa?: boolean;\n  /** @deprecated Use `CA: ['full']`. */\n  ca_full?: boolean;\n  /** @deprecated Use `DE: ['plz']`. */\n  de_plz?: boolean;\n  /** @deprecated Use `FR: ['code_postal']`. */\n  fr_code_postal?: boolean;\n  /** @deprecated Use `AU: ['postcode']`. */\n  au_postcode?: boolean;\n  /** @deprecated Use `CH: ['plz']`. */\n  ch_plz?: boolean;\n  /** @deprecated Use `AT: ['plz']`. */\n  at_plz?: boolean;\n  [country: `${Uppercase<string>}`]:\n    | readonly (\n        | 'zip'\n        | 'zip_plus_four'\n        | 'outward'\n        | 'full'\n        | 'fsa'\n        | 'plz'\n        | 'code_postal'\n        | 'postcode'\n        | 'cep'\n        | 'pin'\n        | 'postal_code'\n        | 'custom'\n      )[]\n    | undefined;\n};\n\nconst LEGACY_POSTAL_SYSTEMS = {\n  us_zip: { country: 'US', system: 'zip' },\n  us_zip_plus_four: { country: 'US', system: 'zip_plus_four' },\n  gb_outward: { country: 'GB', system: 'outward' },\n  gb_full: { country: 'GB', system: 'full' },\n  ca_fsa: { country: 'CA', system: 'fsa' },\n  ca_full: { country: 'CA', system: 'full' },\n  de_plz: { country: 'DE', system: 'plz' },\n  fr_code_postal: { country: 'FR', system: 'code_postal' },\n  au_postcode: { country: 'AU', system: 'postcode' },\n  ch_plz: { country: 'CH', system: 'plz' },\n  at_plz: { country: 'AT', system: 'plz' },\n} as const;\n\nconst LEGACY_POSTAL_BY_COUNTRY_SYSTEM = new Map(\n  Object.entries(LEGACY_POSTAL_SYSTEMS).map(([legacy, { country, system }]) => [`${country}:${system}`, legacy])\n);\n\nconst POSTAL_SYSTEMS_BY_COUNTRY: Record<string, readonly string[]> = {\n  US: ['zip', 'zip_plus_four'],\n  GB: ['outward', 'full'],\n  CA: ['fsa', 'full'],\n  DE: ['plz'],\n  CH: ['plz'],\n  AT: ['plz'],\n  FR: ['code_postal'],\n  AU: ['postcode'],\n  BR: ['cep'],\n  IN: ['pin'],\n  ZA: ['postal_code'],\n};\n\nconst GENERIC_POSTAL_SYSTEMS = ['postal_code', 'custom'] as const;\nconst POSTAL_COUNTRY_KEY_PATTERN = /^[A-Z]{2}$/;\n\nfunction appendUnique(target: string[], value: string): void {\n  if (!target.includes(value)) target.push(value);\n}\n\nfunction assertSupportedPostalSystems(country: string, systems: readonly string[]): void {\n  const allowed = POSTAL_SYSTEMS_BY_COUNTRY[country] ?? GENERIC_POSTAL_SYSTEMS;\n  const invalid = systems.filter(system => !allowed.includes(system));\n  if (invalid.length > 0) {\n    throw new Error(\n      `Invalid geo_postal_areas support for ${country}: ${invalid.join(', ')}. ` +\n        `Supported systems are: ${allowed.join(', ')}.`\n    );\n  }\n}\n\n/**\n * Normalize postal-area capabilities across the AdCP 3.1.0-rc.10 migration.\n *\n * The wire schema now prefers `{ US: ['zip'] }` style country-local systems,\n * while the old `{ us_zip: true }` booleans stay deprecated but accepted\n * through 3.x. This helper is deliberately bidirectional:\n *\n * - legacy booleans add their country-keyed system;\n * - country-keyed systems backfill the matching legacy boolean when one exists;\n * - explicit unsupported legacy booleans are omitted unless the system is\n *   otherwise advertised.\n */\nexport function normalizePostalAreaSupport(input: TargetingPostalAreaSupport): PostalAreaSupport {\n  const normalized: Record<string, string[] | boolean> = {};\n\n  for (const [key, value] of Object.entries(input)) {\n    if (Array.isArray(value)) {\n      if (!POSTAL_COUNTRY_KEY_PATTERN.test(key)) {\n        throw new Error(\n          `Invalid geo_postal_areas key \"${key}\". Use an ISO 3166-1 alpha-2 country code or a deprecated legacy boolean alias.`\n        );\n      }\n      assertSupportedPostalSystems(key, value);\n      const systems = (normalized[key] = Array.isArray(normalized[key]) ? (normalized[key] as string[]) : []);\n      for (const system of value) appendUnique(systems, system);\n      continue;\n    }\n    if (value === true && key in LEGACY_POSTAL_SYSTEMS) {\n      const { country, system } = LEGACY_POSTAL_SYSTEMS[key as keyof typeof LEGACY_POSTAL_SYSTEMS];\n      const systems = (normalized[country] = Array.isArray(normalized[country])\n        ? (normalized[country] as string[])\n        : []);\n      appendUnique(systems, system);\n      continue;\n    }\n    if (value === true) {\n      throw new Error(\n        `Invalid geo_postal_areas legacy alias \"${key}\". Use an ISO 3166-1 alpha-2 country key with supported postal systems.`\n      );\n    }\n  }\n\n  for (const [country, value] of Object.entries(normalized)) {\n    if (!Array.isArray(value)) continue;\n    for (const system of value) {\n      const legacy = LEGACY_POSTAL_BY_COUNTRY_SYSTEM.get(`${country}:${system}`);\n      if (legacy) normalized[legacy] = true;\n    }\n  }\n\n  return normalized as PostalAreaSupport;\n}\n\nexport function normalizeTargetingCapabilities(input: TargetingCapabilities): _MediaBuyTargetingCapabilities {\n  return {\n    ...input,\n    ...(input.geo_postal_areas && { geo_postal_areas: normalizePostalAreaSupport(input.geo_postal_areas) }),\n  } as _MediaBuyTargetingCapabilities;\n}\n\n/**\n * Reporting capabilities the platform supports in `get_media_buy_delivery`.\n *\n * `availableDimensions` is the breakdown axes the platform can group\n * delivery rows by. Vocabulary converged across Scope3 and Prebid.\n */\nexport interface ReportingCapabilities {\n  frequencies: ReadonlyArray<'hourly' | 'daily' | 'weekly'>;\n  expected_delay_minutes: number;\n  timezone: string;\n  metrics: string[];\n  date_range_support: 'date_range' | 'fixed_only';\n  supports_webhooks: boolean;\n  availableDimensions?: ReadonlyArray<\n    'geo' | 'device_type' | 'device_platform' | 'audience' | 'placement' | 'creative' | 'keyword' | 'catalog_item'\n  >;\n}\n\n/**\n * Brand-protocol capabilities — projected onto the wire `brand` block of\n * `get_adcp_capabilities` via the framework's `overrides.brand` deep-merge\n * seam. Adopters who also implement `BrandRightsPlatform` get\n * `rights: true` auto-derived; the other four fields (`right_types`,\n * `available_uses`, `generation_providers`, `description`) are\n * adopter-declared.\n *\n * Wire spec: `protocol/get-adcp-capabilities-response.json#brand`.\n */\nexport type BrandCapabilities = NonNullable<NonNullable<GetAdCPCapabilitiesResponse['brand']>>;\n\n/**\n * Compliance-testing capabilities — projected onto the wire-side\n * `compliance_testing` block of `get_adcp_capabilities` so buyers and\n * conformance harnesses can discover which `comply_test_controller`\n * scenarios the agent supports.\n *\n * Wire spec: `core/get-adcp-capabilities-response.json#compliance_testing`.\n *\n * The `scenarios` array MUST be non-empty when this block is declared\n * (per the spec). `'list_scenarios'` is implicit — adopters don't need\n * to enumerate it.\n */\nexport interface ComplianceTestingCapabilities {\n  /**\n   * Scenarios this agent advertises support for. The wire field is open to\n   * implementation-specific string values; canonical controller scenarios\n   * are recommendations, not an enum constraint. `list_scenarios` remains a\n   * discovery operation rather than a test capability. Framework defaults\n   * this from the adopter-supplied `complyTest` adapter set when omitted.\n   */\n  scenarios?: ReadonlyArray<_ComplianceTestingScenario>;\n}\n"],"mappings":"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","names":[]}

package/dist/lib/server/decisioning/capabilities.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/server/decisioning/capabilities.ts"],"sourcesContent":["/**\n * DecisioningCapabilities — single source of truth for `get_adcp_capabilities`\n * response and any admin UI surface a host wants to render.\n *\n * Adopters declare once. Framework wires the wire-protocol response;\n * adopters' admin tools (or the SDK CLI's `validate_platform_config`) consume\n * the same dataclass so there's no drift between \"what the agent says it\n * supports\" and \"what it actually does.\"\n *\n * Status: Preview / 6.0.\n *\n * @public\n */\n\nimport type { ZodSchema } from 'zod';\nimport type {\n  AdCPSpecialism,\n  MediaChannel,\n  PaymentTerms,\n  PricingModel,\n  GetAdCPCapabilitiesResponse,\n  PostalAreaSupport,\n} from '../../types/tools.generated';\nimport type { ProductMetricOptimizationLike } from '../../utils/capability-rollups';\nimport type { MediaBuyFeatures, AccountCapabilities, CreativeCapabilities } from '../../utils/capabilities';\nimport type { AdcpCapabilitiesOverrides } from '../create-adcp-server';\n\n/**\n * Pre-resolved alias for the wire `media_buy` block. Used as the projection\n * source for the five `media_buy.*` capability fields below so each typed\n * field references a single resolved shape instead of re-walking the\n * `GetAdCPCapabilitiesResponse` type graph independently. Without the\n * alias, `strict + skipLibCheck:false` adopters hit the TS instantiation\n * budget on the published `.d.ts` and tsc OOMs.\n */\ntype _MediaBuyCapabilities = NonNullable<GetAdCPCapabilitiesResponse['media_buy']>;\ntype _MediaBuyTargetingCapabilities = NonNullable<NonNullable<_MediaBuyCapabilities['execution']>['targeting']>;\ntype _ComplianceTestingScenario = NonNullable<\n  NonNullable<GetAdCPCapabilitiesResponse['compliance_testing']>['scenarios']\n>[number];\n\nexport interface DecisioningCapabilities<TConfig = unknown> {\n  /**\n   * Specialisms claimed; framework type-checks these against implemented platform\n   * interfaces. Arrays are `readonly` so adopters can declare with `as const`\n   * (load-bearing for the `RequiredPlatformsFor<S>` compile-time gate).\n   */\n  specialisms: readonly AdCPSpecialism[];\n\n  /**\n   * Creative agents this seller composes with. Framework fetches format catalogs\n   * from each (1h cache) and unions them on `list_creative_formats`. Self-hosting\n   * sellers point at their own `agent_url`; framework calls into their\n   * `CreativePlatform.listFormats()` locally instead of HTTP-fetching.\n   *\n   * `format_ids` filter (optional) subsets a single creative agent's catalog.\n   * Useful when a creative agent hosts 50 formats but this seller only accepts\n   * 10 of them. Filter scope is per-creative-agent: `[{ agent_url: A, format_ids: ['x'] }, { agent_url: B }]`\n   * means \"from A only format x; from B all formats.\"\n   *\n   * Omit for signals-only platforms (`signal-marketplace`, `signal-owned`) — they\n   * sell audience data access, not media inventory, and don't compose with creative agents.\n   */\n  creative_agents?: readonly CreativeAgentRef[];\n\n  /**\n   * Channels this platform sells.\n   *\n   * Omit for non-media-buy platforms — they don't sell ad inventory and have no\n   * channels to declare. Applies to signals (`signal-marketplace`, `signal-owned`),\n   * governance (`governance-spend-authority`, `governance-delivery-monitor`,\n   * `property-lists`, `collection-lists`, `content-standards`), creative-only\n   * (`creative-ad-server`, `creative-template`, `creative-generative`), and\n   * brand (`brand-rights`) platforms.\n   *\n   * **Required at runtime for media-buy platforms.** `validatePlatform` (called\n   * by `createAdcpServerFromPlatform`) throws `PlatformConfigError` when any\n   * `sales-*` specialism is claimed and this field is absent.\n   */\n  channels?: readonly MediaChannel[];\n\n  /**\n   * Pricing models this platform supports.\n   *\n   * Omit for non-media-buy platforms — they don't sell ad inventory and have no\n   * channel-level pricing to declare. For signals platforms specifically, pricing\n   * is declared per-signal in the signal descriptor's `pricing_options[]` instead.\n   * Same non-media-buy specialism set as `channels` above.\n   *\n   * **Required at runtime for media-buy platforms.** `validatePlatform` (called\n   * by `createAdcpServerFromPlatform`) throws `PlatformConfigError` when any\n   * `sales-*` specialism is claimed and this field is absent.\n   */\n  pricingModels?: readonly PricingModel[];\n\n  /** Targeting capabilities. Optional — framework infers reasonable defaults if omitted. */\n  targeting?: TargetingCapabilities;\n\n  /** Reporting capabilities. Optional — framework infers reasonable defaults if omitted. */\n  reporting?: ReportingCapabilities;\n\n  /**\n   * Audience-matching capabilities — projected onto\n   * `get_adcp_capabilities.media_buy.audience_targeting`. Required for\n   * audience-sync adopters (CRM-list adopters that accept hashed\n   * identifiers + UID types) so buyers know which identifier shapes\n   * the platform will match against and what minimum audience size /\n   * matching latency to expect. Omit when the platform doesn't accept\n   * external audience uploads.\n   *\n   * Wire spec: `core/get-adcp-capabilities-response.json#media_buy.audience_targeting`.\n   */\n  audience_targeting?: NonNullable<_MediaBuyCapabilities['audience_targeting']>;\n\n  /**\n   * Conversion-tracking capabilities — projected onto\n   * `get_adcp_capabilities.media_buy.conversion_tracking`. Required for\n   * adopters that accept conversion events via `sync_event_sources` /\n   * `log_event` so buyers know which event types, action sources,\n   * attribution windows, and identifier shapes the platform supports.\n   * Omit when the platform doesn't track conversions.\n   *\n   * Wire spec: `core/get-adcp-capabilities-response.json#media_buy.conversion_tracking`.\n   */\n  conversion_tracking?: NonNullable<_MediaBuyCapabilities['conversion_tracking']>;\n\n  /**\n   * Content-standards capabilities — projected onto\n   * `get_adcp_capabilities.media_buy.content_standards`. Required for\n   * adopters claiming the `content-standards` specialism so buyers know\n   * whether the platform runs local evaluation, which channels it\n   * covers, and whether it supports webhook artifact delivery. Omit\n   * when the platform doesn't ship content-standards artifacts.\n   *\n   * Wire spec: `core/get-adcp-capabilities-response.json#media_buy.content_standards`.\n   */\n  content_standards?: NonNullable<_MediaBuyCapabilities['content_standards']>;\n\n  /**\n   * Seller-level rollup of optimization metrics — projected onto\n   * `get_adcp_capabilities.media_buy.supported_optimization_metrics`.\n   * Added in AdCP 3.1 (adcp#4669). The array union of every product's\n   * `metric_optimization.supported_metrics`. Storyboard runners gate\n   * `metric_optimization`-using scenarios on this field; declaring it\n   * gives buyers an upfront signal of which optimization metrics the\n   * seller can compute against (clicks, views, completed_views, etc.).\n   *\n   * Adopters can compute the rollup from their catalog using the\n   * exported {@link rollupOptimizationMetricsFromProducts} helper —\n   * keeps the declaration in sync with what products actually offer.\n   * Empty arrays are normalized away and the wire field is omitted; use\n   * omission to mean \"no seller-level metric rollup advertised\".\n   *\n   * Wire spec: `core/get-adcp-capabilities-response.json#media_buy.supported_optimization_metrics`.\n   */\n  supported_optimization_metrics?: NonNullable<_MediaBuyCapabilities['supported_optimization_metrics']>;\n\n  /**\n   * Static product-metric summary used for capability rollups.\n   *\n   * When this is present and `supported_optimization_metrics` is omitted,\n   * the framework derives `media_buy.supported_optimization_metrics` as the\n   * sorted union of every product summary's\n   * `metric_optimization.supported_metrics`. Full AdCP `Product` objects work,\n   * but this field is not a general product-discovery surface; a lightweight\n   * startup summary with just the `metric_optimization` block is enough.\n   * Dynamic per-account catalogs should continue to pass an explicit\n   * `supported_optimization_metrics` override. If the derived union is empty,\n   * the framework omits `supported_optimization_metrics` from the wire\n   * capabilities response.\n   */\n  productCatalog?: ReadonlyArray<ProductMetricOptimizationLike>;\n\n  /**\n   * Frequency-cap support declaration — projected onto\n   * `get_adcp_capabilities.media_buy.frequency_capping`. Added in AdCP\n   * 3.1 (adcp#4670). Presence-only object with `supported_per_units` /\n   * `supported_window_units` sub-fields declaring which frequency-cap\n   * shapes the platform honors. Omit when the platform doesn't accept\n   * frequency caps at all; buyers will avoid the field on `pacing.*`.\n   *\n   * Wire spec: `core/get-adcp-capabilities-response.json#media_buy.frequency_capping`.\n   */\n  frequency_capping?: NonNullable<_MediaBuyCapabilities['frequency_capping']>;\n\n  /**\n   * Whether this seller commits to the proposal lifecycle on get_products.\n   * Projected onto `get_adcp_capabilities.media_buy.supports_proposals`.\n   * Direct-buy sellers should declare `false` so proposal-only compliance\n   * storyboards are skipped; sellers with a ProposalManager are auto-derived\n   * as `true` unless they override this explicitly.\n   */\n  supportsProposals?: boolean;\n\n  /**\n   * Brand-protocol capabilities. Projected onto the wire `brand` block of\n   * `get_adcp_capabilities` (`brand: { rights, right_types, available_uses,\n   * generation_providers, description }`). The framework auto-derives\n   * `rights: true` when `BrandRightsPlatform` is supplied; adopters\n   * declare the rest (right_types they license, RightUses they support,\n   * generation providers they issue credentials for).\n   *\n   * REQUIRED when claiming the `'brand-rights'` specialism — enforced at\n   * compile-time via `RequiredCapabilitiesFor<S>`.\n   */\n  brand?: BrandCapabilities;\n\n  /**\n   * Compliance-testing capabilities. The presence of this block declares\n   * the deployment supports deterministic state-machine testing via the\n   * `comply_test_controller` wire tool. Keep this block declared when using\n   * `createAdcpServerFromPlatform(..., { complyTest })`; the framework makes\n   * live principals byte-identical to a production seller that never wired the\n   * controller by hiding this block, filtering `tools/list`, and returning MCP\n   * method-not-found for direct live calls.\n   *\n   * When this block is present, `createAdcpServerFromPlatform` REQUIRES\n   * `opts.complyTest` (the `ComplyControllerConfig` adapter set) to be\n   * supplied — claiming the capability without implementing the\n   * controller is a `PlatformConfigError` at construction.\n   *\n   * Inversely, supplying `opts.complyTest` without declaring this\n   * capability is also caught — the framework derives `scenarios` from\n   * the declared force/simulate/seed adapters and emits the discovery\n   * field on `get_adcp_capabilities` automatically for sandbox/mock\n   * principals. Live principals do not see the block.\n   */\n  compliance_testing?: ComplianceTestingCapabilities;\n\n  /**\n   * Billing parties this platform supports. `'operator'` = retail-media model\n   * (Criteo, Amazon — operator pays the publisher and bills the brand).\n   * `'agent'` = pass-through model (buyer's agent settles directly with the\n   * platform). `'advertiser'` = seller invoices the advertiser directly,\n   * bypassing operator settlement (advertiser-direct sell-side platforms where\n   * the brand is the direct contractual counterparty). Defaults to `['agent']`\n   * when omitted. To express advertiser-direct billing per account, set\n   * `billing.invoicedTo` to a `BrandReference` (the framework maps any\n   * `BrandReference` to `'advertiser'` on the wire).\n   */\n  supportedBillings?: ReadonlyArray<'operator' | 'agent' | 'advertiser'>;\n\n  /**\n   * Payment terms this platform accepts on `sync_accounts.payment_terms`.\n   * Omit to leave terms validation to `accounts.upsert` (or to accept any\n   * schema-valid value). When present, the framework rejects unsupported\n   * requested terms with `PAYMENT_TERMS_NOT_SUPPORTED` before dispatching\n   * the account entry to the adopter.\n   */\n  supportedPaymentTerms?: ReadonlyArray<PaymentTerms>;\n\n  /**\n   * If true, this platform refuses transactions without an authenticated\n   * operator principal (operator-billed retail-media). Framework emits\n   * `AUTH_REQUIRED` envelope before dispatching to the platform.\n   */\n  requireOperatorAuth?: boolean;\n\n  /**\n   * Media-buy feature flags forwarded into `get_adcp_capabilities.media_buy.features`.\n   * Adopter values serve as the base; auto-derived `audience_targeting`,\n   * `conversion_tracking`, and `content_standards` booleans take precedence\n   * for those three keys (overlaid by the framework via the per-domain\n   * `media_buy` override on the inner createAdcpServer call). Use this to\n   * declare `inlineCreativeManagement` and `propertyListFiltering` directly\n   * from `definePlatform`; declare not-supported feature blocks (e.g.\n   * `inlineCreativeManagement: false`) so the conformance runner grades\n   * them `not_applicable` instead of `fail`.\n   *\n   * Resolves the `definePlatform` passthrough gap noted in adcp-client#2199.\n   */\n  features?: Partial<MediaBuyFeatures>;\n\n  /**\n   * Creative-protocol capabilities forwarded into `get_adcp_capabilities.creative`.\n   * Use to declare `supportsCompliance`, `hasCreativeLibrary`,\n   * `supportsGeneration`, and `supportsTransformation` from `definePlatform`.\n   * Adopters that don't run a provenance-verification pipeline should\n   * declare the relevant fields as `false` so creative storyboards gate\n   * cleanly.\n   *\n   * Resolves the `definePlatform` passthrough gap noted in adcp-client#2199.\n   */\n  creative?: Partial<CreativeCapabilities>;\n\n  /**\n   * Account capabilities forwarded into `get_adcp_capabilities.account` as a\n   * base layer. The framework's existing `requireOperatorAuth` and\n   * `supportedBillings` projections overlay on top via the per-domain\n   * `account` override, so explicit projections win on those keys.\n   * `authorizationEndpoint`, `defaultBilling`, `requiredForProducts`, and\n   * `sandbox` are pure adopter-driven additions exposed through this slot.\n   *\n   * Resolves the `definePlatform` passthrough gap noted in adcp-client#2199.\n   */\n  account?: Partial<AccountCapabilities>;\n\n  /**\n   * Deep-merge overrides applied to the wire `get_adcp_capabilities`\n   * response. Use this for fields that the top-level `DecisioningCapabilities`\n   * shape doesn't model — `media_buy.propagation_surfaces`,\n   * `media_buy.measurement_terms`, `signals.discovery_modes`, etc. The\n   * framework's per-domain projections (auto-derived `media_buy`, `brand`,\n   * `account`, `compliance_testing` blocks) are merged AFTER adopter\n   * overrides, so framework-derived values remain authoritative on the keys\n   * the projection engine handles.\n   *\n   * Mirrors `AdcpCapabilitiesConfig.overrides` on the lower-level\n   * `createAdcpServer` API. Resolves the `definePlatform` passthrough gap\n   * noted in adcp-client#2199.\n   */\n  overrides?: AdcpCapabilitiesOverrides;\n\n  /**\n   * Release-precision AdCP versions this platform supports (e.g. `[\"3.0\", \"3.1\"]`).\n   * Forwarded into `get_adcp_capabilities.adcp.supported_versions`. 3.1+\n   * sellers should declare here the same release-precision strings they\n   * emit in `adcp_version` on responses; 3.0-pinned sellers can omit.\n   *\n   * Resolves the same gap previously noted for `supported_versions` —\n   * was unreachable through `definePlatform` because\n   * `CreateAdcpServerFromPlatformOptions` omits `'capabilities'` from\n   * `AdcpServerConfig`. See adcp-client#2199.\n   */\n  supported_versions?: string[];\n\n  /**\n   * Platform-specific config. Strongly typed when the adopter uses the generic.\n   * Example: `class GAM extends DecisioningPlatform<{ networkId: string }>`.\n   */\n  config: TConfig;\n\n  /**\n   * Optional Zod schema for runtime validation of `config`. When provided,\n   * framework validates at platform construction time; missing or wrong-shaped\n   * config rejects the agent at boot rather than at first request.\n   */\n  configSchema?: ZodSchema<TConfig>;\n}\n\nexport interface CreativeAgentRef {\n  agent_url: string;\n  /** Human-readable label for this creative agent. */\n  name?: string;\n  /** Optional allowlist of `format_id.id` values from THIS agent's catalog. Omit to include all. */\n  format_ids?: string[];\n}\n\n/**\n * Targeting capabilities the platform supports in `create_media_buy`. Maps\n * to AdCP `GetAdcpCapabilitiesResponse.media_buy.execution.targeting`.\n *\n * Shape converged across two independently-evolved peer codebases (Scope3\n * `agentic-adapters`, Prebid `salesagent`). Per-geo-system flags rather than\n * coarse enums because the two implementations agreed: real platforms support\n * specific geo identifier formats (Nielsen DMA, Eurostat NUTS2, US ZIP+4), not\n * abstract \"metro\" / \"postal\" categories.\n */\nexport interface TargetingCapabilities {\n  geo_countries?: boolean;\n  geo_regions?: boolean;\n\n  /** Metro / DMA identifier systems. */\n  geo_metros?: {\n    nielsen_dma?: boolean;\n    uk_itl1?: boolean;\n    uk_itl2?: boolean;\n    eurostat_nuts2?: boolean;\n  };\n\n  /**\n   * Postal-code identifier systems.\n   *\n   * AdCP 3.1.0-rc.10 prefers country-keyed arrays, e.g.\n   * `{ US: ['zip'], GB: ['outward'] }`. Deprecated country-fused booleans\n   * such as `{ us_zip: true }` remain accepted for 3.x adopters; the\n   * framework projects both forms with `normalizePostalAreaSupport()` so old\n   * and new buyers can read the capability safely during the migration.\n   */\n  geo_postal_areas?: TargetingPostalAreaSupport;\n\n  /** Geographic-proximity targeting (radius / drive-time / arbitrary geometry). */\n  geo_proximity?: {\n    radius?: boolean;\n    travel_time?: boolean;\n    geometry?: boolean;\n    transport_modes?: ReadonlyArray<'walking' | 'cycling' | 'driving' | 'public_transport'>;\n  };\n\n  /** Age-restriction targeting; `verification_methods` enumerates the assurance levels accepted. */\n  age_restriction?: {\n    supported?: boolean;\n    verification_methods?: ReadonlyArray<\n      'facial_age_estimation' | 'id_document' | 'digital_id' | 'credit_card' | 'world_id'\n    >;\n  };\n\n  device_platform?: boolean;\n  device_type?: boolean;\n  language?: boolean;\n  audience_include?: boolean;\n  audience_exclude?: boolean;\n\n  /** Keyword-targeting match types accepted on positive-match terms. */\n  keyword_targets?: {\n    supported_match_types: ReadonlyArray<'broad' | 'phrase' | 'exact'>;\n  };\n\n  /** Negative-keyword match types accepted. */\n  negative_keywords?: {\n    supported_match_types: ReadonlyArray<'broad' | 'phrase' | 'exact'>;\n  };\n}\n\nexport type TargetingPostalAreaSupport = {\n  US?: readonly ('zip' | 'zip_plus_four')[];\n  GB?: readonly ('outward' | 'full')[];\n  CA?: readonly ('fsa' | 'full')[];\n  DE?: readonly 'plz'[];\n  CH?: readonly 'plz'[];\n  AT?: readonly 'plz'[];\n  FR?: readonly 'code_postal'[];\n  AU?: readonly 'postcode'[];\n  BR?: readonly 'cep'[];\n  IN?: readonly 'pin'[];\n  ZA?: readonly 'postal_code'[];\n  /** @deprecated Use `US: ['zip']`. */\n  us_zip?: boolean;\n  /** @deprecated Use `US: ['zip_plus_four']`. */\n  us_zip_plus_four?: boolean;\n  /** @deprecated Use `GB: ['outward']`. */\n  gb_outward?: boolean;\n  /** @deprecated Use `GB: ['full']`. */\n  gb_full?: boolean;\n  /** @deprecated Use `CA: ['fsa']`. */\n  ca_fsa?: boolean;\n  /** @deprecated Use `CA: ['full']`. */\n  ca_full?: boolean;\n  /** @deprecated Use `DE: ['plz']`. */\n  de_plz?: boolean;\n  /** @deprecated Use `FR: ['code_postal']`. */\n  fr_code_postal?: boolean;\n  /** @deprecated Use `AU: ['postcode']`. */\n  au_postcode?: boolean;\n  /** @deprecated Use `CH: ['plz']`. */\n  ch_plz?: boolean;\n  /** @deprecated Use `AT: ['plz']`. */\n  at_plz?: boolean;\n  [country: `${Uppercase<string>}`]:\n    | readonly (\n        | 'zip'\n        | 'zip_plus_four'\n        | 'outward'\n        | 'full'\n        | 'fsa'\n        | 'plz'\n        | 'code_postal'\n        | 'postcode'\n        | 'cep'\n        | 'pin'\n        | 'postal_code'\n        | 'custom'\n      )[]\n    | undefined;\n};\n\nconst LEGACY_POSTAL_SYSTEMS = {\n  us_zip: { country: 'US', system: 'zip' },\n  us_zip_plus_four: { country: 'US', system: 'zip_plus_four' },\n  gb_outward: { country: 'GB', system: 'outward' },\n  gb_full: { country: 'GB', system: 'full' },\n  ca_fsa: { country: 'CA', system: 'fsa' },\n  ca_full: { country: 'CA', system: 'full' },\n  de_plz: { country: 'DE', system: 'plz' },\n  fr_code_postal: { country: 'FR', system: 'code_postal' },\n  au_postcode: { country: 'AU', system: 'postcode' },\n  ch_plz: { country: 'CH', system: 'plz' },\n  at_plz: { country: 'AT', system: 'plz' },\n} as const;\n\nconst LEGACY_POSTAL_BY_COUNTRY_SYSTEM = new Map(\n  Object.entries(LEGACY_POSTAL_SYSTEMS).map(([legacy, { country, system }]) => [`${country}:${system}`, legacy])\n);\n\nconst POSTAL_SYSTEMS_BY_COUNTRY: Record<string, readonly string[]> = {\n  US: ['zip', 'zip_plus_four'],\n  GB: ['outward', 'full'],\n  CA: ['fsa', 'full'],\n  DE: ['plz'],\n  CH: ['plz'],\n  AT: ['plz'],\n  FR: ['code_postal'],\n  AU: ['postcode'],\n  BR: ['cep'],\n  IN: ['pin'],\n  ZA: ['postal_code'],\n};\n\nconst GENERIC_POSTAL_SYSTEMS = ['postal_code', 'custom'] as const;\nconst POSTAL_COUNTRY_KEY_PATTERN = /^[A-Z]{2}$/;\n\nfunction appendUnique(target: string[], value: string): void {\n  if (!target.includes(value)) target.push(value);\n}\n\nfunction assertSupportedPostalSystems(country: string, systems: readonly string[]): void {\n  const allowed = POSTAL_SYSTEMS_BY_COUNTRY[country] ?? GENERIC_POSTAL_SYSTEMS;\n  const invalid = systems.filter(system => !allowed.includes(system));\n  if (invalid.length > 0) {\n    throw new Error(\n      `Invalid geo_postal_areas support for ${country}: ${invalid.join(', ')}. ` +\n        `Supported systems are: ${allowed.join(', ')}.`\n    );\n  }\n}\n\n/**\n * Normalize postal-area capabilities across the AdCP 3.1.0-rc.10 migration.\n *\n * The wire schema now prefers `{ US: ['zip'] }` style country-local systems,\n * while the old `{ us_zip: true }` booleans stay deprecated but accepted\n * through 3.x. This helper is deliberately bidirectional:\n *\n * - legacy booleans add their country-keyed system;\n * - country-keyed systems backfill the matching legacy boolean when one exists;\n * - explicit unsupported legacy booleans are omitted unless the system is\n *   otherwise advertised.\n */\nexport function normalizePostalAreaSupport(input: TargetingPostalAreaSupport): PostalAreaSupport {\n  const normalized: Record<string, string[] | boolean> = {};\n\n  for (const [key, value] of Object.entries(input)) {\n    if (Array.isArray(value)) {\n      if (!POSTAL_COUNTRY_KEY_PATTERN.test(key)) {\n        throw new Error(\n          `Invalid geo_postal_areas key \"${key}\". Use an ISO 3166-1 alpha-2 country code or a deprecated legacy boolean alias.`\n        );\n      }\n      assertSupportedPostalSystems(key, value);\n      const systems = (normalized[key] = Array.isArray(normalized[key]) ? (normalized[key] as string[]) : []);\n      for (const system of value) appendUnique(systems, system);\n      continue;\n    }\n    if (value === true && key in LEGACY_POSTAL_SYSTEMS) {\n      const { country, system } = LEGACY_POSTAL_SYSTEMS[key as keyof typeof LEGACY_POSTAL_SYSTEMS];\n      const systems = (normalized[country] = Array.isArray(normalized[country])\n        ? (normalized[country] as string[])\n        : []);\n      appendUnique(systems, system);\n      continue;\n    }\n    if (value === true) {\n      throw new Error(\n        `Invalid geo_postal_areas legacy alias \"${key}\". Use an ISO 3166-1 alpha-2 country key with supported postal systems.`\n      );\n    }\n  }\n\n  for (const [country, value] of Object.entries(normalized)) {\n    if (!Array.isArray(value)) continue;\n    for (const system of value) {\n      const legacy = LEGACY_POSTAL_BY_COUNTRY_SYSTEM.get(`${country}:${system}`);\n      if (legacy) normalized[legacy] = true;\n    }\n  }\n\n  return normalized as PostalAreaSupport;\n}\n\nexport function normalizeTargetingCapabilities(input: TargetingCapabilities): _MediaBuyTargetingCapabilities {\n  return {\n    ...input,\n    ...(input.geo_postal_areas && { geo_postal_areas: normalizePostalAreaSupport(input.geo_postal_areas) }),\n  } as _MediaBuyTargetingCapabilities;\n}\n\n/**\n * Reporting capabilities the platform supports in `get_media_buy_delivery`.\n *\n * `availableDimensions` is the breakdown axes the platform can group\n * delivery rows by. Vocabulary converged across Scope3 and Prebid.\n */\nexport interface ReportingCapabilities {\n  frequencies: ReadonlyArray<'hourly' | 'daily' | 'weekly'>;\n  expected_delay_minutes: number;\n  timezone: string;\n  metrics: string[];\n  date_range_support: 'date_range' | 'fixed_only';\n  supports_webhooks: boolean;\n  availableDimensions?: ReadonlyArray<\n    'geo' | 'device_type' | 'device_platform' | 'audience' | 'placement' | 'creative' | 'keyword' | 'catalog_item'\n  >;\n}\n\n/**\n * Brand-protocol capabilities — projected onto the wire `brand` block of\n * `get_adcp_capabilities` via the framework's `overrides.brand` deep-merge\n * seam. Adopters who also implement `BrandRightsPlatform` get\n * `rights: true` auto-derived; the other four fields (`right_types`,\n * `available_uses`, `generation_providers`, `description`) are\n * adopter-declared.\n *\n * Wire spec: `protocol/get-adcp-capabilities-response.json#brand`.\n */\nexport type BrandCapabilities = NonNullable<NonNullable<GetAdCPCapabilitiesResponse['brand']>>;\n\n/**\n * Compliance-testing capabilities — projected onto the wire-side\n * `compliance_testing` block of `get_adcp_capabilities` so buyers and\n * conformance harnesses can discover which `comply_test_controller`\n * scenarios the agent supports.\n *\n * Wire spec: `core/get-adcp-capabilities-response.json#compliance_testing`.\n *\n * The `scenarios` array MUST be non-empty when this block is declared\n * (per the spec). `'list_scenarios'` is implicit — adopters don't need\n * to enumerate it.\n */\nexport interface ComplianceTestingCapabilities {\n  /**\n   * Scenarios this agent advertises support for. Wire enum is the\n   * canonical scenario enum, excluding `list_scenarios` because that\n   * is a discovery operation rather than a test capability. Framework\n   * defaults this from the adopter-supplied `complyTest` adapter set\n   * when omitted.\n   */\n  scenarios?: ReadonlyArray<_ComplianceTestingScenario>;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../src/lib/server/decisioning/capabilities.ts"],"sourcesContent":["/**\n * DecisioningCapabilities — single source of truth for `get_adcp_capabilities`\n * response and any admin UI surface a host wants to render.\n *\n * Adopters declare once. Framework wires the wire-protocol response;\n * adopters' admin tools (or the SDK CLI's `validate_platform_config`) consume\n * the same dataclass so there's no drift between \"what the agent says it\n * supports\" and \"what it actually does.\"\n *\n * Status: Preview / 6.0.\n *\n * @public\n */\n\nimport type { ZodSchema } from 'zod';\nimport type {\n  AdCPSpecialism,\n  MediaChannel,\n  PaymentTerms,\n  PricingModel,\n  GetAdCPCapabilitiesResponse,\n  PostalAreaSupport,\n} from '../../types/tools.generated';\nimport type { ProductMetricOptimizationLike } from '../../utils/capability-rollups';\nimport type { MediaBuyFeatures, AccountCapabilities, CreativeCapabilities } from '../../utils/capabilities';\nimport type { AdcpCapabilitiesOverrides } from '../create-adcp-server';\n\n/**\n * Pre-resolved alias for the wire `media_buy` block. Used as the projection\n * source for the five `media_buy.*` capability fields below so each typed\n * field references a single resolved shape instead of re-walking the\n * `GetAdCPCapabilitiesResponse` type graph independently. Without the\n * alias, `strict + skipLibCheck:false` adopters hit the TS instantiation\n * budget on the published `.d.ts` and tsc OOMs.\n */\ntype _MediaBuyCapabilities = NonNullable<GetAdCPCapabilitiesResponse['media_buy']>;\ntype _MediaBuyTargetingCapabilities = NonNullable<NonNullable<_MediaBuyCapabilities['execution']>['targeting']>;\ntype _ComplianceTestingScenario = NonNullable<\n  NonNullable<GetAdCPCapabilitiesResponse['compliance_testing']>['scenarios']\n>[number];\n\nexport interface DecisioningCapabilities<TConfig = unknown> {\n  /**\n   * Specialisms claimed; framework type-checks these against implemented platform\n   * interfaces. Arrays are `readonly` so adopters can declare with `as const`\n   * (load-bearing for the `RequiredPlatformsFor<S>` compile-time gate).\n   */\n  specialisms: readonly AdCPSpecialism[];\n\n  /**\n   * Creative agents this seller composes with. Framework fetches format catalogs\n   * from each (1h cache) and unions them on `list_creative_formats`. Self-hosting\n   * sellers point at their own `agent_url`; framework calls into their\n   * `CreativePlatform.listFormats()` locally instead of HTTP-fetching.\n   *\n   * `format_ids` filter (optional) subsets a single creative agent's catalog.\n   * Useful when a creative agent hosts 50 formats but this seller only accepts\n   * 10 of them. Filter scope is per-creative-agent: `[{ agent_url: A, format_ids: ['x'] }, { agent_url: B }]`\n   * means \"from A only format x; from B all formats.\"\n   *\n   * Omit for signals-only platforms (`signal-marketplace`, `signal-owned`) — they\n   * sell audience data access, not media inventory, and don't compose with creative agents.\n   */\n  creative_agents?: readonly CreativeAgentRef[];\n\n  /**\n   * Channels this platform sells.\n   *\n   * Omit for non-media-buy platforms — they don't sell ad inventory and have no\n   * channels to declare. Applies to signals (`signal-marketplace`, `signal-owned`),\n   * governance (`governance-spend-authority`, `governance-delivery-monitor`,\n   * `property-lists`, `collection-lists`, `content-standards`), creative-only\n   * (`creative-ad-server`, `creative-template`, `creative-generative`), and\n   * brand (`brand-rights`) platforms.\n   *\n   * **Required at runtime for media-buy platforms.** `validatePlatform` (called\n   * by `createAdcpServerFromPlatform`) throws `PlatformConfigError` when any\n   * `sales-*` specialism is claimed and this field is absent.\n   */\n  channels?: readonly MediaChannel[];\n\n  /**\n   * Pricing models this platform supports.\n   *\n   * Omit for non-media-buy platforms — they don't sell ad inventory and have no\n   * channel-level pricing to declare. For signals platforms specifically, pricing\n   * is declared per-signal in the signal descriptor's `pricing_options[]` instead.\n   * Same non-media-buy specialism set as `channels` above.\n   *\n   * **Required at runtime for media-buy platforms.** `validatePlatform` (called\n   * by `createAdcpServerFromPlatform`) throws `PlatformConfigError` when any\n   * `sales-*` specialism is claimed and this field is absent.\n   */\n  pricingModels?: readonly PricingModel[];\n\n  /** Targeting capabilities. Optional — framework infers reasonable defaults if omitted. */\n  targeting?: TargetingCapabilities;\n\n  /** Reporting capabilities. Optional — framework infers reasonable defaults if omitted. */\n  reporting?: ReportingCapabilities;\n\n  /**\n   * Audience-matching capabilities — projected onto\n   * `get_adcp_capabilities.media_buy.audience_targeting`. Required for\n   * audience-sync adopters (CRM-list adopters that accept hashed\n   * identifiers + UID types) so buyers know which identifier shapes\n   * the platform will match against and what minimum audience size /\n   * matching latency to expect. Omit when the platform doesn't accept\n   * external audience uploads.\n   *\n   * Wire spec: `core/get-adcp-capabilities-response.json#media_buy.audience_targeting`.\n   */\n  audience_targeting?: NonNullable<_MediaBuyCapabilities['audience_targeting']>;\n\n  /**\n   * Conversion-tracking capabilities — projected onto\n   * `get_adcp_capabilities.media_buy.conversion_tracking`. Required for\n   * adopters that accept conversion events via `sync_event_sources` /\n   * `log_event` so buyers know which event types, action sources,\n   * attribution windows, and identifier shapes the platform supports.\n   * Omit when the platform doesn't track conversions.\n   *\n   * Wire spec: `core/get-adcp-capabilities-response.json#media_buy.conversion_tracking`.\n   */\n  conversion_tracking?: NonNullable<_MediaBuyCapabilities['conversion_tracking']>;\n\n  /**\n   * Content-standards capabilities — projected onto\n   * `get_adcp_capabilities.media_buy.content_standards`. Required for\n   * adopters claiming the `content-standards` specialism so buyers know\n   * whether the platform runs local evaluation, which channels it\n   * covers, and whether it supports webhook artifact delivery. Omit\n   * when the platform doesn't ship content-standards artifacts.\n   *\n   * Wire spec: `core/get-adcp-capabilities-response.json#media_buy.content_standards`.\n   */\n  content_standards?: NonNullable<_MediaBuyCapabilities['content_standards']>;\n\n  /**\n   * Seller-level rollup of optimization metrics — projected onto\n   * `get_adcp_capabilities.media_buy.supported_optimization_metrics`.\n   * Added in AdCP 3.1 (adcp#4669). The array union of every product's\n   * `metric_optimization.supported_metrics`. Storyboard runners gate\n   * `metric_optimization`-using scenarios on this field; declaring it\n   * gives buyers an upfront signal of which optimization metrics the\n   * seller can compute against (clicks, views, completed_views, etc.).\n   *\n   * Adopters can compute the rollup from their catalog using the\n   * exported {@link rollupOptimizationMetricsFromProducts} helper —\n   * keeps the declaration in sync with what products actually offer.\n   * Empty arrays are normalized away and the wire field is omitted; use\n   * omission to mean \"no seller-level metric rollup advertised\".\n   *\n   * Wire spec: `core/get-adcp-capabilities-response.json#media_buy.supported_optimization_metrics`.\n   */\n  supported_optimization_metrics?: NonNullable<_MediaBuyCapabilities['supported_optimization_metrics']>;\n\n  /**\n   * Static product-metric summary used for capability rollups.\n   *\n   * When this is present and `supported_optimization_metrics` is omitted,\n   * the framework derives `media_buy.supported_optimization_metrics` as the\n   * sorted union of every product summary's\n   * `metric_optimization.supported_metrics`. Full AdCP `Product` objects work,\n   * but this field is not a general product-discovery surface; a lightweight\n   * startup summary with just the `metric_optimization` block is enough.\n   * Dynamic per-account catalogs should continue to pass an explicit\n   * `supported_optimization_metrics` override. If the derived union is empty,\n   * the framework omits `supported_optimization_metrics` from the wire\n   * capabilities response.\n   */\n  productCatalog?: ReadonlyArray<ProductMetricOptimizationLike>;\n\n  /**\n   * Frequency-cap support declaration — projected onto\n   * `get_adcp_capabilities.media_buy.frequency_capping`. Added in AdCP\n   * 3.1 (adcp#4670). Presence-only object with `supported_per_units` /\n   * `supported_window_units` sub-fields declaring which frequency-cap\n   * shapes the platform honors. Omit when the platform doesn't accept\n   * frequency caps at all; buyers will avoid the field on `pacing.*`.\n   *\n   * Wire spec: `core/get-adcp-capabilities-response.json#media_buy.frequency_capping`.\n   */\n  frequency_capping?: NonNullable<_MediaBuyCapabilities['frequency_capping']>;\n\n  /**\n   * Whether this seller commits to the proposal lifecycle on get_products.\n   * Projected onto `get_adcp_capabilities.media_buy.supports_proposals`.\n   * Direct-buy sellers should declare `false` so proposal-only compliance\n   * storyboards are skipped; sellers with a ProposalManager are auto-derived\n   * as `true` unless they override this explicitly.\n   */\n  supportsProposals?: boolean;\n\n  /**\n   * Brand-protocol capabilities. Projected onto the wire `brand` block of\n   * `get_adcp_capabilities` (`brand: { rights, right_types, available_uses,\n   * generation_providers, description }`). The framework auto-derives\n   * `rights: true` when `BrandRightsPlatform` is supplied; adopters\n   * declare the rest (right_types they license, RightUses they support,\n   * generation providers they issue credentials for).\n   *\n   * REQUIRED when claiming the `'brand-rights'` specialism — enforced at\n   * compile-time via `RequiredCapabilitiesFor<S>`.\n   */\n  brand?: BrandCapabilities;\n\n  /**\n   * Compliance-testing capabilities. The presence of this block declares\n   * the deployment supports deterministic state-machine testing via the\n   * `comply_test_controller` wire tool. Keep this block declared when using\n   * `createAdcpServerFromPlatform(..., { complyTest })`; the framework makes\n   * live principals byte-identical to a production seller that never wired the\n   * controller by hiding this block, filtering `tools/list`, and returning MCP\n   * method-not-found for direct live calls.\n   *\n   * When this block is present, `createAdcpServerFromPlatform` REQUIRES\n   * `opts.complyTest` (the `ComplyControllerConfig` adapter set) to be\n   * supplied — claiming the capability without implementing the\n   * controller is a `PlatformConfigError` at construction.\n   *\n   * Inversely, supplying `opts.complyTest` without declaring this\n   * capability is also caught — the framework derives `scenarios` from\n   * the declared force/simulate/seed adapters and emits the discovery\n   * field on `get_adcp_capabilities` automatically for sandbox/mock\n   * principals. Live principals do not see the block.\n   */\n  compliance_testing?: ComplianceTestingCapabilities;\n\n  /**\n   * Billing parties this platform supports. `'operator'` = retail-media model\n   * (Criteo, Amazon — operator pays the publisher and bills the brand).\n   * `'agent'` = pass-through model (buyer's agent settles directly with the\n   * platform). `'advertiser'` = seller invoices the advertiser directly,\n   * bypassing operator settlement (advertiser-direct sell-side platforms where\n   * the brand is the direct contractual counterparty). Defaults to `['agent']`\n   * when omitted. To express advertiser-direct billing per account, set\n   * `billing.invoicedTo` to a `BrandReference` (the framework maps any\n   * `BrandReference` to `'advertiser'` on the wire).\n   */\n  supportedBillings?: ReadonlyArray<'operator' | 'agent' | 'advertiser'>;\n\n  /**\n   * Payment terms this platform accepts on `sync_accounts.payment_terms`.\n   * Omit to leave terms validation to `accounts.upsert` (or to accept any\n   * schema-valid value). When present, the framework rejects unsupported\n   * requested terms with `PAYMENT_TERMS_NOT_SUPPORTED` before dispatching\n   * the account entry to the adopter.\n   */\n  supportedPaymentTerms?: ReadonlyArray<PaymentTerms>;\n\n  /**\n   * If true, this platform refuses transactions without an authenticated\n   * operator principal (operator-billed retail-media). Framework emits\n   * `AUTH_REQUIRED` envelope before dispatching to the platform.\n   */\n  requireOperatorAuth?: boolean;\n\n  /**\n   * Media-buy feature flags forwarded into `get_adcp_capabilities.media_buy.features`.\n   * Adopter values serve as the base; auto-derived `audience_targeting`,\n   * `conversion_tracking`, and `content_standards` booleans take precedence\n   * for those three keys (overlaid by the framework via the per-domain\n   * `media_buy` override on the inner createAdcpServer call). Use this to\n   * declare `inlineCreativeManagement` and `propertyListFiltering` directly\n   * from `definePlatform`; declare not-supported feature blocks (e.g.\n   * `inlineCreativeManagement: false`) so the conformance runner grades\n   * them `not_applicable` instead of `fail`.\n   *\n   * Resolves the `definePlatform` passthrough gap noted in adcp-client#2199.\n   */\n  features?: Partial<MediaBuyFeatures>;\n\n  /**\n   * Creative-protocol capabilities forwarded into `get_adcp_capabilities.creative`.\n   * Use to declare `supportsCompliance`, `hasCreativeLibrary`,\n   * `supportsGeneration`, and `supportsTransformation` from `definePlatform`.\n   * Adopters that don't run a provenance-verification pipeline should\n   * declare the relevant fields as `false` so creative storyboards gate\n   * cleanly.\n   *\n   * Resolves the `definePlatform` passthrough gap noted in adcp-client#2199.\n   */\n  creative?: Partial<CreativeCapabilities>;\n\n  /**\n   * Account capabilities forwarded into `get_adcp_capabilities.account` as a\n   * base layer. The framework's existing `requireOperatorAuth` and\n   * `supportedBillings` projections overlay on top via the per-domain\n   * `account` override, so explicit projections win on those keys.\n   * `authorizationEndpoint`, `defaultBilling`, `requiredForProducts`, and\n   * `sandbox` are pure adopter-driven additions exposed through this slot.\n   *\n   * Resolves the `definePlatform` passthrough gap noted in adcp-client#2199.\n   */\n  account?: Partial<AccountCapabilities>;\n\n  /**\n   * Deep-merge overrides applied to the wire `get_adcp_capabilities`\n   * response. Use this for fields that the top-level `DecisioningCapabilities`\n   * shape doesn't model — `media_buy.propagation_surfaces`,\n   * `media_buy.measurement_terms`, `signals.discovery_modes`, etc. The\n   * framework's per-domain projections (auto-derived `media_buy`, `brand`,\n   * `account`, `compliance_testing` blocks) are merged AFTER adopter\n   * overrides, so framework-derived values remain authoritative on the keys\n   * the projection engine handles.\n   *\n   * Mirrors `AdcpCapabilitiesConfig.overrides` on the lower-level\n   * `createAdcpServer` API. Resolves the `definePlatform` passthrough gap\n   * noted in adcp-client#2199.\n   */\n  overrides?: AdcpCapabilitiesOverrides;\n\n  /**\n   * Release-precision AdCP versions this platform supports (e.g. `[\"3.0\", \"3.1\"]`).\n   * Forwarded into `get_adcp_capabilities.adcp.supported_versions`. 3.1+\n   * sellers should declare here the same release-precision strings they\n   * emit in `adcp_version` on responses; 3.0-pinned sellers can omit.\n   *\n   * Resolves the same gap previously noted for `supported_versions` —\n   * was unreachable through `definePlatform` because\n   * `CreateAdcpServerFromPlatformOptions` omits `'capabilities'` from\n   * `AdcpServerConfig`. See adcp-client#2199.\n   */\n  supported_versions?: string[];\n\n  /**\n   * Platform-specific config. Strongly typed when the adopter uses the generic.\n   * Example: `class GAM extends DecisioningPlatform<{ networkId: string }>`.\n   */\n  config: TConfig;\n\n  /**\n   * Optional Zod schema for runtime validation of `config`. When provided,\n   * framework validates at platform construction time; missing or wrong-shaped\n   * config rejects the agent at boot rather than at first request.\n   */\n  configSchema?: ZodSchema<TConfig>;\n}\n\nexport interface CreativeAgentRef {\n  agent_url: string;\n  /** Human-readable label for this creative agent. */\n  name?: string;\n  /** Optional allowlist of `format_id.id` values from THIS agent's catalog. Omit to include all. */\n  format_ids?: string[];\n}\n\n/**\n * Targeting capabilities the platform supports in `create_media_buy`. Maps\n * to AdCP `GetAdcpCapabilitiesResponse.media_buy.execution.targeting`.\n *\n * Shape converged across two independently-evolved peer codebases (Scope3\n * `agentic-adapters`, Prebid `salesagent`). Per-geo-system flags rather than\n * coarse enums because the two implementations agreed: real platforms support\n * specific geo identifier formats (Nielsen DMA, Eurostat NUTS2, US ZIP+4), not\n * abstract \"metro\" / \"postal\" categories.\n */\nexport interface TargetingCapabilities {\n  geo_countries?: boolean;\n  geo_regions?: boolean;\n\n  /** Metro / DMA identifier systems. */\n  geo_metros?: {\n    nielsen_dma?: boolean;\n    uk_itl1?: boolean;\n    uk_itl2?: boolean;\n    eurostat_nuts2?: boolean;\n  };\n\n  /**\n   * Postal-code identifier systems.\n   *\n   * AdCP 3.1.0-rc.10 prefers country-keyed arrays, e.g.\n   * `{ US: ['zip'], GB: ['outward'] }`. Deprecated country-fused booleans\n   * such as `{ us_zip: true }` remain accepted for 3.x adopters; the\n   * framework projects both forms with `normalizePostalAreaSupport()` so old\n   * and new buyers can read the capability safely during the migration.\n   */\n  geo_postal_areas?: TargetingPostalAreaSupport;\n\n  /** Geographic-proximity targeting (radius / drive-time / arbitrary geometry). */\n  geo_proximity?: {\n    radius?: boolean;\n    travel_time?: boolean;\n    geometry?: boolean;\n    transport_modes?: ReadonlyArray<'walking' | 'cycling' | 'driving' | 'public_transport'>;\n  };\n\n  /** Age-restriction targeting; `verification_methods` enumerates the assurance levels accepted. */\n  age_restriction?: {\n    supported?: boolean;\n    verification_methods?: ReadonlyArray<\n      'facial_age_estimation' | 'id_document' | 'digital_id' | 'credit_card' | 'world_id'\n    >;\n  };\n\n  device_platform?: boolean;\n  device_type?: boolean;\n  language?: boolean;\n  audience_include?: boolean;\n  audience_exclude?: boolean;\n\n  /** Keyword-targeting match types accepted on positive-match terms. */\n  keyword_targets?: {\n    supported_match_types: ReadonlyArray<'broad' | 'phrase' | 'exact'>;\n  };\n\n  /** Negative-keyword match types accepted. */\n  negative_keywords?: {\n    supported_match_types: ReadonlyArray<'broad' | 'phrase' | 'exact'>;\n  };\n}\n\nexport type TargetingPostalAreaSupport = {\n  US?: readonly ('zip' | 'zip_plus_four')[];\n  GB?: readonly ('outward' | 'full')[];\n  CA?: readonly ('fsa' | 'full')[];\n  DE?: readonly 'plz'[];\n  CH?: readonly 'plz'[];\n  AT?: readonly 'plz'[];\n  FR?: readonly 'code_postal'[];\n  AU?: readonly 'postcode'[];\n  BR?: readonly 'cep'[];\n  IN?: readonly 'pin'[];\n  ZA?: readonly 'postal_code'[];\n  /** @deprecated Use `US: ['zip']`. */\n  us_zip?: boolean;\n  /** @deprecated Use `US: ['zip_plus_four']`. */\n  us_zip_plus_four?: boolean;\n  /** @deprecated Use `GB: ['outward']`. */\n  gb_outward?: boolean;\n  /** @deprecated Use `GB: ['full']`. */\n  gb_full?: boolean;\n  /** @deprecated Use `CA: ['fsa']`. */\n  ca_fsa?: boolean;\n  /** @deprecated Use `CA: ['full']`. */\n  ca_full?: boolean;\n  /** @deprecated Use `DE: ['plz']`. */\n  de_plz?: boolean;\n  /** @deprecated Use `FR: ['code_postal']`. */\n  fr_code_postal?: boolean;\n  /** @deprecated Use `AU: ['postcode']`. */\n  au_postcode?: boolean;\n  /** @deprecated Use `CH: ['plz']`. */\n  ch_plz?: boolean;\n  /** @deprecated Use `AT: ['plz']`. */\n  at_plz?: boolean;\n  [country: `${Uppercase<string>}`]:\n    | readonly (\n        | 'zip'\n        | 'zip_plus_four'\n        | 'outward'\n        | 'full'\n        | 'fsa'\n        | 'plz'\n        | 'code_postal'\n        | 'postcode'\n        | 'cep'\n        | 'pin'\n        | 'postal_code'\n        | 'custom'\n      )[]\n    | undefined;\n};\n\nconst LEGACY_POSTAL_SYSTEMS = {\n  us_zip: { country: 'US', system: 'zip' },\n  us_zip_plus_four: { country: 'US', system: 'zip_plus_four' },\n  gb_outward: { country: 'GB', system: 'outward' },\n  gb_full: { country: 'GB', system: 'full' },\n  ca_fsa: { country: 'CA', system: 'fsa' },\n  ca_full: { country: 'CA', system: 'full' },\n  de_plz: { country: 'DE', system: 'plz' },\n  fr_code_postal: { country: 'FR', system: 'code_postal' },\n  au_postcode: { country: 'AU', system: 'postcode' },\n  ch_plz: { country: 'CH', system: 'plz' },\n  at_plz: { country: 'AT', system: 'plz' },\n} as const;\n\nconst LEGACY_POSTAL_BY_COUNTRY_SYSTEM = new Map(\n  Object.entries(LEGACY_POSTAL_SYSTEMS).map(([legacy, { country, system }]) => [`${country}:${system}`, legacy])\n);\n\nconst POSTAL_SYSTEMS_BY_COUNTRY: Record<string, readonly string[]> = {\n  US: ['zip', 'zip_plus_four'],\n  GB: ['outward', 'full'],\n  CA: ['fsa', 'full'],\n  DE: ['plz'],\n  CH: ['plz'],\n  AT: ['plz'],\n  FR: ['code_postal'],\n  AU: ['postcode'],\n  BR: ['cep'],\n  IN: ['pin'],\n  ZA: ['postal_code'],\n};\n\nconst GENERIC_POSTAL_SYSTEMS = ['postal_code', 'custom'] as const;\nconst POSTAL_COUNTRY_KEY_PATTERN = /^[A-Z]{2}$/;\n\nfunction appendUnique(target: string[], value: string): void {\n  if (!target.includes(value)) target.push(value);\n}\n\nfunction assertSupportedPostalSystems(country: string, systems: readonly string[]): void {\n  const allowed = POSTAL_SYSTEMS_BY_COUNTRY[country] ?? GENERIC_POSTAL_SYSTEMS;\n  const invalid = systems.filter(system => !allowed.includes(system));\n  if (invalid.length > 0) {\n    throw new Error(\n      `Invalid geo_postal_areas support for ${country}: ${invalid.join(', ')}. ` +\n        `Supported systems are: ${allowed.join(', ')}.`\n    );\n  }\n}\n\n/**\n * Normalize postal-area capabilities across the AdCP 3.1.0-rc.10 migration.\n *\n * The wire schema now prefers `{ US: ['zip'] }` style country-local systems,\n * while the old `{ us_zip: true }` booleans stay deprecated but accepted\n * through 3.x. This helper is deliberately bidirectional:\n *\n * - legacy booleans add their country-keyed system;\n * - country-keyed systems backfill the matching legacy boolean when one exists;\n * - explicit unsupported legacy booleans are omitted unless the system is\n *   otherwise advertised.\n */\nexport function normalizePostalAreaSupport(input: TargetingPostalAreaSupport): PostalAreaSupport {\n  const normalized: Record<string, string[] | boolean> = {};\n\n  for (const [key, value] of Object.entries(input)) {\n    if (Array.isArray(value)) {\n      if (!POSTAL_COUNTRY_KEY_PATTERN.test(key)) {\n        throw new Error(\n          `Invalid geo_postal_areas key \"${key}\". Use an ISO 3166-1 alpha-2 country code or a deprecated legacy boolean alias.`\n        );\n      }\n      assertSupportedPostalSystems(key, value);\n      const systems = (normalized[key] = Array.isArray(normalized[key]) ? (normalized[key] as string[]) : []);\n      for (const system of value) appendUnique(systems, system);\n      continue;\n    }\n    if (value === true && key in LEGACY_POSTAL_SYSTEMS) {\n      const { country, system } = LEGACY_POSTAL_SYSTEMS[key as keyof typeof LEGACY_POSTAL_SYSTEMS];\n      const systems = (normalized[country] = Array.isArray(normalized[country])\n        ? (normalized[country] as string[])\n        : []);\n      appendUnique(systems, system);\n      continue;\n    }\n    if (value === true) {\n      throw new Error(\n        `Invalid geo_postal_areas legacy alias \"${key}\". Use an ISO 3166-1 alpha-2 country key with supported postal systems.`\n      );\n    }\n  }\n\n  for (const [country, value] of Object.entries(normalized)) {\n    if (!Array.isArray(value)) continue;\n    for (const system of value) {\n      const legacy = LEGACY_POSTAL_BY_COUNTRY_SYSTEM.get(`${country}:${system}`);\n      if (legacy) normalized[legacy] = true;\n    }\n  }\n\n  return normalized as PostalAreaSupport;\n}\n\nexport function normalizeTargetingCapabilities(input: TargetingCapabilities): _MediaBuyTargetingCapabilities {\n  return {\n    ...input,\n    ...(input.geo_postal_areas && { geo_postal_areas: normalizePostalAreaSupport(input.geo_postal_areas) }),\n  } as _MediaBuyTargetingCapabilities;\n}\n\n/**\n * Reporting capabilities the platform supports in `get_media_buy_delivery`.\n *\n * `availableDimensions` is the breakdown axes the platform can group\n * delivery rows by. Vocabulary converged across Scope3 and Prebid.\n */\nexport interface ReportingCapabilities {\n  frequencies: ReadonlyArray<'hourly' | 'daily' | 'weekly'>;\n  expected_delay_minutes: number;\n  timezone: string;\n  metrics: string[];\n  date_range_support: 'date_range' | 'fixed_only';\n  supports_webhooks: boolean;\n  availableDimensions?: ReadonlyArray<\n    'geo' | 'device_type' | 'device_platform' | 'audience' | 'placement' | 'creative' | 'keyword' | 'catalog_item'\n  >;\n}\n\n/**\n * Brand-protocol capabilities — projected onto the wire `brand` block of\n * `get_adcp_capabilities` via the framework's `overrides.brand` deep-merge\n * seam. Adopters who also implement `BrandRightsPlatform` get\n * `rights: true` auto-derived; the other four fields (`right_types`,\n * `available_uses`, `generation_providers`, `description`) are\n * adopter-declared.\n *\n * Wire spec: `protocol/get-adcp-capabilities-response.json#brand`.\n */\nexport type BrandCapabilities = NonNullable<NonNullable<GetAdCPCapabilitiesResponse['brand']>>;\n\n/**\n * Compliance-testing capabilities — projected onto the wire-side\n * `compliance_testing` block of `get_adcp_capabilities` so buyers and\n * conformance harnesses can discover which `comply_test_controller`\n * scenarios the agent supports.\n *\n * Wire spec: `core/get-adcp-capabilities-response.json#compliance_testing`.\n *\n * The `scenarios` array MUST be non-empty when this block is declared\n * (per the spec). `'list_scenarios'` is implicit — adopters don't need\n * to enumerate it.\n */\nexport interface ComplianceTestingCapabilities {\n  /**\n   * Scenarios this agent advertises support for. The wire field is open to\n   * implementation-specific string values; canonical controller scenarios\n   * are recommendations, not an enum constraint. `list_scenarios` remains a\n   * discovery operation rather than a test capability. Framework defaults\n   * this from the adopter-supplied `complyTest` adapter set when omitted.\n   */\n  scenarios?: ReadonlyArray<_ComplianceTestingScenario>;\n}\n"],"mappings":"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","names":[]}

package/dist/lib/server/decisioning/runtime/entity-hydration.generated.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../src/lib/server/decisioning/runtime/entity-hydration.generated.ts"],"sourcesContent":["// Generated entity-hydration field map — do NOT edit by hand\n//\n// Source: `schemas/cache/3.1.15/manifest.json` + per-tool request\n// schemas. Every top-level `x-entity`-tagged string field on a request\n// schema lands here. The runtime hydrator (`from-platform.ts` →\n// `hydrateForTool`) walks this map plus the hand-curated\n// `ENTITY_TO_RESOURCE_KIND` table to drive auto-hydration without\n// re-walking schemas at startup.\n//\n// Renaming-firewall: if the spec renames `media_buy_id` → `mediabuy_id`,\n// the `x-entity` tag travels with it; the next codegen run picks up\n// the new field name automatically.\n//\n// Regenerate with: npm run generate-entity-hydration\n\nexport interface EntityHydrationField {\n  /** Top-level property on the wire request object. */\n  readonly field: string;\n  /** Spec `x-entity` annotation — maps to `ResourceKind` at runtime. */\n  readonly xEntity: string;\n}\n\nexport const TOOL_ENTITY_FIELDS: Readonly<Record<string, ReadonlyArray<EntityHydrationField>>> = {\n  acquire_rights: [\n    { field: \"pricing_option_id\", xEntity: \"vendor_pricing_option\" },\n    { field: \"rights_id\", xEntity: \"rights_grant\" },\n  ],\n  activate_signal: [\n    { field: \"pricing_option_id\", xEntity: \"vendor_pricing_option\" },\n    { field: \"signal_agent_segment_id\", xEntity: \"signal_activation_id\" },\n  ],\n  build_creative: [\n    { field: \"creative_id\", xEntity: \"creative\" },\n    { field: \"media_buy_id\", xEntity: \"media_buy\" },\n    { field: \"package_id\", xEntity: \"package\" },\n    { field: \"refine_from_build_variant_id\", xEntity: \"build_variant\" },\n    { field: \"transformer_id\", xEntity: \"transformer\" },\n  ],\n  check_governance: [\n    { field: \"plan_id\", xEntity: \"governance_plan\" },\n  ],\n  create_media_buy: [\n    { field: \"plan_id\", xEntity: \"governance_plan\" },\n  ],\n  delete_collection_list: [\n    { field: \"list_id\", xEntity: \"collection_list\" },\n  ],\n  delete_property_list: [\n    { field: \"list_id\", xEntity: \"property_list\" },\n  ],\n  get_brand_identity: [\n    { field: \"brand_id\", xEntity: \"advertiser_brand\" },\n  ],\n  get_collection_list: [\n    { field: \"list_id\", xEntity: \"collection_list\" },\n  ],\n  get_property_list: [\n    { field: \"list_id\", xEntity: \"property_list\" },\n  ],\n  get_rights: [\n    { field: \"brand_id\", xEntity: \"rights_holder_brand\" },\n  ],\n  get_task_status: [\n    { field: \"task_id\", xEntity: \"task\" },\n  ],\n  log_event: [\n    { field: \"event_source_id\", xEntity: \"event_source\" },\n  ],\n  preview_creative: [\n    { field: \"creative_id\", xEntity: \"creative\" },\n  ],\n  provide_performance_feedback: [\n    { field: \"creative_id\", xEntity: \"creative\" },\n    { field: \"media_buy_id\", xEntity: \"media_buy\" },\n    { field: \"package_id\", xEntity: \"package\" },\n  ],\n  report_plan_outcome: [\n    { field: \"check_id\", xEntity: \"governance_check\" },\n    { field: \"plan_id\", xEntity: \"governance_plan\" },\n  ],\n  si_get_offering: [\n    { field: \"offering_id\", xEntity: \"offering\" },\n  ],\n  si_initiate_session: [\n    { field: \"media_buy_id\", xEntity: \"media_buy\" },\n    { field: \"offering_id\", xEntity: \"offering\" },\n  ],\n  si_send_message: [\n    { field: \"session_id\", xEntity: \"si_session\" },\n  ],\n  si_terminate_session: [\n    { field: \"session_id\", xEntity: \"si_session\" },\n  ],\n  update_collection_list: [\n    { field: \"list_id\", xEntity: \"collection_list\" },\n  ],\n  update_media_buy: [\n    { field: \"media_buy_id\", xEntity: \"media_buy\" },\n  ],\n  update_property_list: [\n    { field: \"list_id\", xEntity: \"property_list\" },\n  ],\n  update_rights: [\n    { field: \"pricing_option_id\", xEntity: \"vendor_pricing_option\" },\n    { field: \"rights_id\", xEntity: \"rights_grant\" },\n  ],\n  validate_property_delivery: [\n    { field: \"list_id\", xEntity: \"property_list\" },\n  ],\n};\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../../src/lib/server/decisioning/runtime/entity-hydration.generated.ts"],"sourcesContent":["// Generated entity-hydration field map — do NOT edit by hand\n//\n// Source: `schemas/cache/3.1.20/manifest.json` + per-tool request\n// schemas. Every top-level `x-entity`-tagged string field on a request\n// schema lands here. The runtime hydrator (`from-platform.ts` →\n// `hydrateForTool`) walks this map plus the hand-curated\n// `ENTITY_TO_RESOURCE_KIND` table to drive auto-hydration without\n// re-walking schemas at startup.\n//\n// Renaming-firewall: if the spec renames `media_buy_id` → `mediabuy_id`,\n// the `x-entity` tag travels with it; the next codegen run picks up\n// the new field name automatically.\n//\n// Regenerate with: npm run generate-entity-hydration\n\nexport interface EntityHydrationField {\n  /** Top-level property on the wire request object. */\n  readonly field: string;\n  /** Spec `x-entity` annotation — maps to `ResourceKind` at runtime. */\n  readonly xEntity: string;\n}\n\nexport const TOOL_ENTITY_FIELDS: Readonly<Record<string, ReadonlyArray<EntityHydrationField>>> = {\n  acquire_rights: [\n    { field: \"pricing_option_id\", xEntity: \"vendor_pricing_option\" },\n    { field: \"rights_id\", xEntity: \"rights_grant\" },\n  ],\n  activate_signal: [\n    { field: \"pricing_option_id\", xEntity: \"vendor_pricing_option\" },\n    { field: \"signal_agent_segment_id\", xEntity: \"signal_activation_id\" },\n  ],\n  build_creative: [\n    { field: \"creative_id\", xEntity: \"creative\" },\n    { field: \"media_buy_id\", xEntity: \"media_buy\" },\n    { field: \"package_id\", xEntity: \"package\" },\n    { field: \"refine_from_build_variant_id\", xEntity: \"build_variant\" },\n    { field: \"transformer_id\", xEntity: \"transformer\" },\n  ],\n  check_governance: [\n    { field: \"plan_id\", xEntity: \"governance_plan\" },\n  ],\n  create_media_buy: [\n    { field: \"plan_id\", xEntity: \"governance_plan\" },\n  ],\n  delete_collection_list: [\n    { field: \"list_id\", xEntity: \"collection_list\" },\n  ],\n  delete_property_list: [\n    { field: \"list_id\", xEntity: \"property_list\" },\n  ],\n  get_brand_identity: [\n    { field: \"brand_id\", xEntity: \"advertiser_brand\" },\n  ],\n  get_collection_list: [\n    { field: \"list_id\", xEntity: \"collection_list\" },\n  ],\n  get_property_list: [\n    { field: \"list_id\", xEntity: \"property_list\" },\n  ],\n  get_rights: [\n    { field: \"brand_id\", xEntity: \"rights_holder_brand\" },\n  ],\n  get_task_status: [\n    { field: \"task_id\", xEntity: \"task\" },\n  ],\n  log_event: [\n    { field: \"event_source_id\", xEntity: \"event_source\" },\n  ],\n  preview_creative: [\n    { field: \"creative_id\", xEntity: \"creative\" },\n  ],\n  provide_performance_feedback: [\n    { field: \"creative_id\", xEntity: \"creative\" },\n    { field: \"media_buy_id\", xEntity: \"media_buy\" },\n    { field: \"package_id\", xEntity: \"package\" },\n  ],\n  report_plan_outcome: [\n    { field: \"check_id\", xEntity: \"governance_check\" },\n    { field: \"plan_id\", xEntity: \"governance_plan\" },\n  ],\n  si_get_offering: [\n    { field: \"offering_id\", xEntity: \"offering\" },\n  ],\n  si_initiate_session: [\n    { field: \"media_buy_id\", xEntity: \"media_buy\" },\n    { field: \"offering_id\", xEntity: \"offering\" },\n  ],\n  si_send_message: [\n    { field: \"session_id\", xEntity: \"si_session\" },\n  ],\n  si_terminate_session: [\n    { field: \"session_id\", xEntity: \"si_session\" },\n  ],\n  update_collection_list: [\n    { field: \"list_id\", xEntity: \"collection_list\" },\n  ],\n  update_media_buy: [\n    { field: \"media_buy_id\", xEntity: \"media_buy\" },\n  ],\n  update_property_list: [\n    { field: \"list_id\", xEntity: \"property_list\" },\n  ],\n  update_rights: [\n    { field: \"pricing_option_id\", xEntity: \"vendor_pricing_option\" },\n    { field: \"rights_id\", xEntity: \"rights_grant\" },\n  ],\n  validate_property_delivery: [\n    { field: \"list_id\", xEntity: \"property_list\" },\n  ],\n};\n"],"mappings":"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","names":[]}

package/dist/lib/server/decisioning/runtime/entity-hydration.generated.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../src/lib/server/decisioning/runtime/entity-hydration.generated.ts"],"sourcesContent":["// Generated entity-hydration field map — do NOT edit by hand\n//\n// Source: `schemas/cache/3.1.15/manifest.json` + per-tool request\n// schemas. Every top-level `x-entity`-tagged string field on a request\n// schema lands here. The runtime hydrator (`from-platform.ts` →\n// `hydrateForTool`) walks this map plus the hand-curated\n// `ENTITY_TO_RESOURCE_KIND` table to drive auto-hydration without\n// re-walking schemas at startup.\n//\n// Renaming-firewall: if the spec renames `media_buy_id` → `mediabuy_id`,\n// the `x-entity` tag travels with it; the next codegen run picks up\n// the new field name automatically.\n//\n// Regenerate with: npm run generate-entity-hydration\n\nexport interface EntityHydrationField {\n  /** Top-level property on the wire request object. */\n  readonly field: string;\n  /** Spec `x-entity` annotation — maps to `ResourceKind` at runtime. */\n  readonly xEntity: string;\n}\n\nexport const TOOL_ENTITY_FIELDS: Readonly<Record<string, ReadonlyArray<EntityHydrationField>>> = {\n  acquire_rights: [\n    { field: \"pricing_option_id\", xEntity: \"vendor_pricing_option\" },\n    { field: \"rights_id\", xEntity: \"rights_grant\" },\n  ],\n  activate_signal: [\n    { field: \"pricing_option_id\", xEntity: \"vendor_pricing_option\" },\n    { field: \"signal_agent_segment_id\", xEntity: \"signal_activation_id\" },\n  ],\n  build_creative: [\n    { field: \"creative_id\", xEntity: \"creative\" },\n    { field: \"media_buy_id\", xEntity: \"media_buy\" },\n    { field: \"package_id\", xEntity: \"package\" },\n    { field: \"refine_from_build_variant_id\", xEntity: \"build_variant\" },\n    { field: \"transformer_id\", xEntity: \"transformer\" },\n  ],\n  check_governance: [\n    { field: \"plan_id\", xEntity: \"governance_plan\" },\n  ],\n  create_media_buy: [\n    { field: \"plan_id\", xEntity: \"governance_plan\" },\n  ],\n  delete_collection_list: [\n    { field: \"list_id\", xEntity: \"collection_list\" },\n  ],\n  delete_property_list: [\n    { field: \"list_id\", xEntity: \"property_list\" },\n  ],\n  get_brand_identity: [\n    { field: \"brand_id\", xEntity: \"advertiser_brand\" },\n  ],\n  get_collection_list: [\n    { field: \"list_id\", xEntity: \"collection_list\" },\n  ],\n  get_property_list: [\n    { field: \"list_id\", xEntity: \"property_list\" },\n  ],\n  get_rights: [\n    { field: \"brand_id\", xEntity: \"rights_holder_brand\" },\n  ],\n  get_task_status: [\n    { field: \"task_id\", xEntity: \"task\" },\n  ],\n  log_event: [\n    { field: \"event_source_id\", xEntity: \"event_source\" },\n  ],\n  preview_creative: [\n    { field: \"creative_id\", xEntity: \"creative\" },\n  ],\n  provide_performance_feedback: [\n    { field: \"creative_id\", xEntity: \"creative\" },\n    { field: \"media_buy_id\", xEntity: \"media_buy\" },\n    { field: \"package_id\", xEntity: \"package\" },\n  ],\n  report_plan_outcome: [\n    { field: \"check_id\", xEntity: \"governance_check\" },\n    { field: \"plan_id\", xEntity: \"governance_plan\" },\n  ],\n  si_get_offering: [\n    { field: \"offering_id\", xEntity: \"offering\" },\n  ],\n  si_initiate_session: [\n    { field: \"media_buy_id\", xEntity: \"media_buy\" },\n    { field: \"offering_id\", xEntity: \"offering\" },\n  ],\n  si_send_message: [\n    { field: \"session_id\", xEntity: \"si_session\" },\n  ],\n  si_terminate_session: [\n    { field: \"session_id\", xEntity: \"si_session\" },\n  ],\n  update_collection_list: [\n    { field: \"list_id\", xEntity: \"collection_list\" },\n  ],\n  update_media_buy: [\n    { field: \"media_buy_id\", xEntity: \"media_buy\" },\n  ],\n  update_property_list: [\n    { field: \"list_id\", xEntity: \"property_list\" },\n  ],\n  update_rights: [\n    { field: \"pricing_option_id\", xEntity: \"vendor_pricing_option\" },\n    { field: \"rights_id\", xEntity: \"rights_grant\" },\n  ],\n  validate_property_delivery: [\n    { field: \"list_id\", xEntity: \"property_list\" },\n  ],\n};\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../../src/lib/server/decisioning/runtime/entity-hydration.generated.ts"],"sourcesContent":["// Generated entity-hydration field map — do NOT edit by hand\n//\n// Source: `schemas/cache/3.1.20/manifest.json` + per-tool request\n// schemas. Every top-level `x-entity`-tagged string field on a request\n// schema lands here. The runtime hydrator (`from-platform.ts` →\n// `hydrateForTool`) walks this map plus the hand-curated\n// `ENTITY_TO_RESOURCE_KIND` table to drive auto-hydration without\n// re-walking schemas at startup.\n//\n// Renaming-firewall: if the spec renames `media_buy_id` → `mediabuy_id`,\n// the `x-entity` tag travels with it; the next codegen run picks up\n// the new field name automatically.\n//\n// Regenerate with: npm run generate-entity-hydration\n\nexport interface EntityHydrationField {\n  /** Top-level property on the wire request object. */\n  readonly field: string;\n  /** Spec `x-entity` annotation — maps to `ResourceKind` at runtime. */\n  readonly xEntity: string;\n}\n\nexport const TOOL_ENTITY_FIELDS: Readonly<Record<string, ReadonlyArray<EntityHydrationField>>> = {\n  acquire_rights: [\n    { field: \"pricing_option_id\", xEntity: \"vendor_pricing_option\" },\n    { field: \"rights_id\", xEntity: \"rights_grant\" },\n  ],\n  activate_signal: [\n    { field: \"pricing_option_id\", xEntity: \"vendor_pricing_option\" },\n    { field: \"signal_agent_segment_id\", xEntity: \"signal_activation_id\" },\n  ],\n  build_creative: [\n    { field: \"creative_id\", xEntity: \"creative\" },\n    { field: \"media_buy_id\", xEntity: \"media_buy\" },\n    { field: \"package_id\", xEntity: \"package\" },\n    { field: \"refine_from_build_variant_id\", xEntity: \"build_variant\" },\n    { field: \"transformer_id\", xEntity: \"transformer\" },\n  ],\n  check_governance: [\n    { field: \"plan_id\", xEntity: \"governance_plan\" },\n  ],\n  create_media_buy: [\n    { field: \"plan_id\", xEntity: \"governance_plan\" },\n  ],\n  delete_collection_list: [\n    { field: \"list_id\", xEntity: \"collection_list\" },\n  ],\n  delete_property_list: [\n    { field: \"list_id\", xEntity: \"property_list\" },\n  ],\n  get_brand_identity: [\n    { field: \"brand_id\", xEntity: \"advertiser_brand\" },\n  ],\n  get_collection_list: [\n    { field: \"list_id\", xEntity: \"collection_list\" },\n  ],\n  get_property_list: [\n    { field: \"list_id\", xEntity: \"property_list\" },\n  ],\n  get_rights: [\n    { field: \"brand_id\", xEntity: \"rights_holder_brand\" },\n  ],\n  get_task_status: [\n    { field: \"task_id\", xEntity: \"task\" },\n  ],\n  log_event: [\n    { field: \"event_source_id\", xEntity: \"event_source\" },\n  ],\n  preview_creative: [\n    { field: \"creative_id\", xEntity: \"creative\" },\n  ],\n  provide_performance_feedback: [\n    { field: \"creative_id\", xEntity: \"creative\" },\n    { field: \"media_buy_id\", xEntity: \"media_buy\" },\n    { field: \"package_id\", xEntity: \"package\" },\n  ],\n  report_plan_outcome: [\n    { field: \"check_id\", xEntity: \"governance_check\" },\n    { field: \"plan_id\", xEntity: \"governance_plan\" },\n  ],\n  si_get_offering: [\n    { field: \"offering_id\", xEntity: \"offering\" },\n  ],\n  si_initiate_session: [\n    { field: \"media_buy_id\", xEntity: \"media_buy\" },\n    { field: \"offering_id\", xEntity: \"offering\" },\n  ],\n  si_send_message: [\n    { field: \"session_id\", xEntity: \"si_session\" },\n  ],\n  si_terminate_session: [\n    { field: \"session_id\", xEntity: \"si_session\" },\n  ],\n  update_collection_list: [\n    { field: \"list_id\", xEntity: \"collection_list\" },\n  ],\n  update_media_buy: [\n    { field: \"media_buy_id\", xEntity: \"media_buy\" },\n  ],\n  update_property_list: [\n    { field: \"list_id\", xEntity: \"property_list\" },\n  ],\n  update_rights: [\n    { field: \"pricing_option_id\", xEntity: \"vendor_pricing_option\" },\n    { field: \"rights_id\", xEntity: \"rights_grant\" },\n  ],\n  validate_property_delivery: [\n    { field: \"list_id\", xEntity: \"property_list\" },\n  ],\n};\n"],"mappings":"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","names":[]}