@adcp/sdk 17.0.0-beta.8 → 17.0.0-beta.9

package/dist/lib/schemas-data/3.1/core/activation-key.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/core/activation-key.json",
+  "$id": "/schemas/3.1.31/core/activation-key.json",
   "title": "Activation Key",
   "description": "Universal identifier for using a signal on a destination platform. Can be either a segment ID or a key-value pair depending on the platform's targeting mechanism.",
   "type": "object",

package/dist/lib/schemas-data/3.1/core/ad-inventory-config.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/core/ad-inventory-config.json",
+  "$id": "/schemas/3.1.31/core/ad-inventory-config.json",
   "title": "Ad Inventory Configuration",
   "description": "Break-based ad inventory configuration for an installment. Describes the ad breaks available within the content. For non-break ad formats (host reads, integrations, sponsorships), use product placements instead.",
   "type": "object",

package/dist/lib/schemas-data/3.1/core/agent-encryption-key.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/core/agent-encryption-key.json",
+  "$id": "/schemas/3.1.31/core/agent-encryption-key.json",
   "title": "Agent Encryption Key",
   "description": "X25519 public key for HPKE encryption. Used for TMPX exposure token encryption with HPKE mode_base.",
   "type": "object",

package/dist/lib/schemas-data/3.1/core/agent-signing-key.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/core/agent-signing-key.json",
+  "$id": "/schemas/3.1.31/core/agent-signing-key.json",
   "title": "Agent Signing Key",
   "description": "Publisher-attested public key material for an authorized agent. Buyers use these keys to verify signed agent responses against the trust anchor published in adagents.json rather than trusting key discovery from the agent domain alone.",
   "type": "object",

package/dist/lib/schemas-data/3.1/core/app-item.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/core/app-item.json",
+  "$id": "/schemas/3.1.31/core/app-item.json",
   "title": "App Item",
   "description": "A mobile application within an app-type catalog. Carries the app metadata and store identifiers that platforms use for app install campaigns and re-engagement ads. Maps to Google App Campaigns, Apple Search Ads, Meta App Ads, TikTok App Campaigns, and Snapchat App Install Ads. Each item represents one app on one platform — iOS and Android variants are separate items.",
   "type": "object",
@@ -72,7 +72,7 @@
       "description": "Deep link URI for re-engagement campaigns targeting existing users. Use Universal Links (iOS) or App Links (Android) where available (e.g., 'https://acmegames.com/app/level/5'). Falls back to URI scheme (e.g., 'acmegames://level/5') when universal links are not configured."
     },
     "price": {
-      "$ref": "/schemas/3.1.29/core/price.json",
+      "$ref": "/schemas/3.1.31/core/price.json",
       "description": "App download price. Set amount to 0 for free apps."
     },
     "rating": {
@@ -102,12 +102,12 @@
       "type": "array",
       "description": "Typed creative asset pools for this app. Uses the same OfferingAssetGroup structure as offering-type catalogs. Standard group IDs: 'images_landscape' (promotional hero), 'images_vertical' (9:16 for Snap, Stories), 'images_square' (1:1 for display), 'video' (gameplay or demo video). Supplements icon_url and screenshots for platform-specific format requirements.",
       "items": {
-        "$ref": "/schemas/3.1.29/core/offering-asset-group.json"
+        "$ref": "/schemas/3.1.31/core/offering-asset-group.json"
       },
       "minItems": 1
     },
     "ext": {
-      "$ref": "/schemas/3.1.29/core/ext.json"
+      "$ref": "/schemas/3.1.31/core/ext.json"
     }
   },
   "required": [

package/dist/lib/schemas-data/3.1/core/asset-group-vocabulary.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/core/asset-group-vocabulary.json",
+  "$id": "/schemas/3.1.31/core/asset-group-vocabulary.json",
   "title": "AdCP Asset Group Vocabulary Registry",
   "description": "Canonical registry of asset_group_id values used in offering asset groups (OfferingAssetGroup) and in v2 product format declarations. Non-canonical IDs remain valid for platform-specific extensions; this registry codifies the recommended canonical set so that buyers and sellers share a vocabulary for the most common slot roles. Validators may emit soft warnings on non-canonical IDs to encourage convergence.\n\nThe registry covers everything the buyer ships in the manifest's `assets` map — both directly-rendered creative content (image, video, audio) AND content the seller consumes for production (script, creative_brief, video_brief). The seller dispatches per the format's slot declaration. There is no separate \"inputs\" map on the manifest; everything is an asset.\n\n**Two-tier boundary (normative).** This registry is the *canonical, portable* tier — IAB-aligned, platform-agnostic slot roles every adopter shares (`headline`, `body_text`, `main_image`, `cta`, `landing_page_url`, etc.). Platform-specific asset identifiers (e.g., YouTube video IDs, Pinterest pin IDs, TikTok video IDs, Snap attachment IDs, Meta Advantage+ creative IDs) MUST NOT be added here — they live on the canonical's `platform_extensions[]` (URI+digest reference to the platform's extension schema) so the canonical registry stays portable. Earlier drafts carried `youtube_video_id` and `pin_id` here; they were dropped in 3.1 GA precisely because adding them set precedent for every platform's identifier vocabulary to leak into the canonical tier, defeating the registry's portability purpose. Adopters needing to reference an existing platform-hosted asset attach a `platform_extensions[]` entry on the format declaration whose extension schema defines the platform-specific ID slot.",
   "version": "1.3.0",

package/dist/lib/schemas-data/3.1/core/assets/asset-union.json

@@ -1,69 +1,69 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/core/assets/asset-union.json",
+  "$id": "/schemas/3.1.31/core/assets/asset-union.json",
   "title": "AssetVariant",
   "description": "Canonical union of all asset variant schemas. Referenced from creative-asset.json and creative-manifest.json to ensure a single named type is emitted by schema-to-TypeScript tooling. Add new asset types here and to the creative/asset-types registry.",
   "type": "object",
   "oneOf": [
     {
-      "$ref": "/schemas/3.1.29/core/assets/image-asset.json"
+      "$ref": "/schemas/3.1.31/core/assets/image-asset.json"
     },
     {
-      "$ref": "/schemas/3.1.29/core/assets/video-asset.json"
+      "$ref": "/schemas/3.1.31/core/assets/video-asset.json"
     },
     {
-      "$ref": "/schemas/3.1.29/core/assets/audio-asset.json"
+      "$ref": "/schemas/3.1.31/core/assets/audio-asset.json"
     },
     {
-      "$ref": "/schemas/3.1.29/core/assets/vast-asset.json"
+      "$ref": "/schemas/3.1.31/core/assets/vast-asset.json"
     },
     {
-      "$ref": "/schemas/3.1.29/core/assets/text-asset.json"
+      "$ref": "/schemas/3.1.31/core/assets/text-asset.json"
     },
     {
-      "$ref": "/schemas/3.1.29/core/assets/url-asset.json"
+      "$ref": "/schemas/3.1.31/core/assets/url-asset.json"
     },
     {
-      "$ref": "/schemas/3.1.29/core/assets/html-asset.json"
+      "$ref": "/schemas/3.1.31/core/assets/html-asset.json"
     },
     {
-      "$ref": "/schemas/3.1.29/core/assets/javascript-asset.json"
+      "$ref": "/schemas/3.1.31/core/assets/javascript-asset.json"
     },
     {
-      "$ref": "/schemas/3.1.29/core/assets/zip-asset.json"
+      "$ref": "/schemas/3.1.31/core/assets/zip-asset.json"
     },
     {
-      "$ref": "/schemas/3.1.29/core/assets/webhook-asset.json"
+      "$ref": "/schemas/3.1.31/core/assets/webhook-asset.json"
     },
     {
-      "$ref": "/schemas/3.1.29/core/assets/css-asset.json"
+      "$ref": "/schemas/3.1.31/core/assets/css-asset.json"
     },
     {
-      "$ref": "/schemas/3.1.29/core/assets/daast-asset.json"
+      "$ref": "/schemas/3.1.31/core/assets/daast-asset.json"
     },
     {
-      "$ref": "/schemas/3.1.29/core/assets/markdown-asset.json"
+      "$ref": "/schemas/3.1.31/core/assets/markdown-asset.json"
     },
     {
-      "$ref": "/schemas/3.1.29/core/assets/brief-asset.json"
+      "$ref": "/schemas/3.1.31/core/assets/brief-asset.json"
     },
     {
-      "$ref": "/schemas/3.1.29/core/assets/catalog-asset.json"
+      "$ref": "/schemas/3.1.31/core/assets/catalog-asset.json"
     },
     {
-      "$ref": "/schemas/3.1.29/core/assets/published-post-asset.json"
+      "$ref": "/schemas/3.1.31/core/assets/published-post-asset.json"
     },
     {
-      "$ref": "/schemas/3.1.29/core/assets/card-asset.json"
+      "$ref": "/schemas/3.1.31/core/assets/card-asset.json"
     },
     {
-      "$ref": "/schemas/3.1.29/core/assets/pixel-tracker-asset.json"
+      "$ref": "/schemas/3.1.31/core/assets/pixel-tracker-asset.json"
     },
     {
-      "$ref": "/schemas/3.1.29/core/assets/vast-tracker-asset.json"
+      "$ref": "/schemas/3.1.31/core/assets/vast-tracker-asset.json"
     },
     {
-      "$ref": "/schemas/3.1.29/core/assets/daast-tracker-asset.json"
+      "$ref": "/schemas/3.1.31/core/assets/daast-tracker-asset.json"
     }
   ],
   "discriminator": {

package/dist/lib/schemas-data/3.1/core/assets/audio-asset.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/core/assets/audio-asset.json",
+  "$id": "/schemas/3.1.31/core/assets/audio-asset.json",
   "title": "Audio Asset",
   "description": "Audio asset with URL and technical specifications",
   "type": "object",
@@ -38,7 +38,7 @@
       "description": "Sampling rate in Hz (e.g., 44100, 48000, 96000)"
     },
     "channels": {
-      "$ref": "/schemas/3.1.29/enums/audio-channel-layout.json",
+      "$ref": "/schemas/3.1.31/enums/audio-channel-layout.json",
       "description": "Channel configuration"
     },
     "bit_depth": {
@@ -70,7 +70,7 @@
       "x-accessibility": true
     },
     "provenance": {
-      "$ref": "/schemas/3.1.29/core/provenance.json",
+      "$ref": "/schemas/3.1.31/core/provenance.json",
       "description": "Provenance metadata for this asset, overrides manifest-level provenance"
     }
   },

package/dist/lib/schemas-data/3.1/core/assets/brief-asset.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/core/assets/brief-asset.json",
+  "$id": "/schemas/3.1.31/core/assets/brief-asset.json",
   "title": "Brief Asset",
   "description": "Campaign-level creative context as an asset. Carries the creative brief through the manifest so it travels with the creative through regeneration, resizing, and auditing.",
   "type": "object",
@@ -16,7 +16,7 @@
   ],
   "allOf": [
     {
-      "$ref": "/schemas/3.1.29/core/creative-brief.json"
+      "$ref": "/schemas/3.1.31/core/creative-brief.json"
     }
   ]
 }

package/dist/lib/schemas-data/3.1/core/assets/card-asset.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/core/assets/card-asset.json",
+  "$id": "/schemas/3.1.31/core/assets/card-asset.json",
   "title": "Card Asset",
   "description": "A single card in a multi-card creative (image_carousel, future composed carousels). Carries: `media` (an image OR video asset), optional `headline` (short text), optional `description` (longer text), optional `cta` (call-to-action label), optional `landing_page_url` (url asset with `url_type: \"clickthrough\"`).\n\nCovers the multi-card patterns across Meta carousel, Pinterest sponsored pin, Snap Collection, TikTok carousel, and AI-surface result cards. The two-field text shape (`headline` + `description`) reflects how almost every adopter splits short labels from longer copy; Pinterest pin description and Meta per-card description both go in `description`.\n\nUsed as the array element type for the `cards` slot on image_carousel canonicals. Adopters MUST NOT invent per-card key conventions like `card_0_headline` / `cards.0.headline` — the manifest's `assets.cards` value is an array of card-asset objects, period. Per-card platform extensions (e.g., Meta-specific carousel attributes, Pinterest rich-pin metadata, Snap Collection price tags) attach via the `platform_extensions` field, never via inline non-canonical keys.",
   "type": "object",
@@ -18,10 +18,10 @@
       "description": "The card's primary visual asset. Either an `image` or `video` asset, matching the parent format's `allowed_card_media_asset_types` parameter.",
       "oneOf": [
         {
-          "$ref": "/schemas/3.1.29/core/assets/image-asset.json"
+          "$ref": "/schemas/3.1.31/core/assets/image-asset.json"
         },
         {
-          "$ref": "/schemas/3.1.29/core/assets/video-asset.json"
+          "$ref": "/schemas/3.1.31/core/assets/video-asset.json"
         }
       ],
       "discriminator": {
@@ -41,18 +41,18 @@
       "description": "Optional per-card call-to-action label (e.g., 'SHOP_NOW', 'LEARN_MORE'). When the parent format declares `cta_values` (allowed CTA labels), the per-card `cta` MUST be one of those values. Lets a Meta or TikTok carousel show different CTAs per card."
     },
     "landing_page_url": {
-      "$ref": "/schemas/3.1.29/core/assets/url-asset.json",
+      "$ref": "/schemas/3.1.31/core/assets/url-asset.json",
       "description": "Optional per-card click-through URL. URL asset with `url_type: \"clickthrough\"`."
     },
     "platform_extensions": {
       "type": "array",
       "description": "Per-card platform-specific extensions (URI+digest references). Same hosting model as format-level platform_extensions. Use this for Meta carousel-card attributes, Pinterest pin overrides, etc. — NEVER inline non-canonical keys on the card object directly.",
       "items": {
-        "$ref": "/schemas/3.1.29/core/platform-extension-ref.json"
+        "$ref": "/schemas/3.1.31/core/platform-extension-ref.json"
       }
     },
     "provenance": {
-      "$ref": "/schemas/3.1.29/core/provenance.json",
+      "$ref": "/schemas/3.1.31/core/provenance.json",
       "description": "Provenance metadata for this card, overrides manifest-level provenance."
     }
   },

package/dist/lib/schemas-data/3.1/core/assets/catalog-asset.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/core/assets/catalog-asset.json",
+  "$id": "/schemas/3.1.31/core/assets/catalog-asset.json",
   "title": "Catalog Asset",
   "description": "A typed data feed as a creative asset. Carries catalog context (products, stores, jobs, etc.) within the manifest's assets map.",
   "type": "object",
@@ -16,7 +16,7 @@
   ],
   "allOf": [
     {
-      "$ref": "/schemas/3.1.29/core/catalog.json"
+      "$ref": "/schemas/3.1.31/core/catalog.json"
     }
   ]
 }

package/dist/lib/schemas-data/3.1/core/assets/css-asset.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/core/assets/css-asset.json",
+  "$id": "/schemas/3.1.31/core/assets/css-asset.json",
   "title": "CSS Asset",
   "description": "CSS stylesheet asset",
   "type": "object",
@@ -19,7 +19,7 @@
       "description": "CSS media query context (e.g., 'screen', 'print')"
     },
     "provenance": {
-      "$ref": "/schemas/3.1.29/core/provenance.json",
+      "$ref": "/schemas/3.1.31/core/provenance.json",
       "description": "Provenance metadata for this asset, overrides manifest-level provenance"
     }
   },

package/dist/lib/schemas-data/3.1/core/assets/daast-asset.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/core/assets/daast-asset.json",
+  "$id": "/schemas/3.1.31/core/assets/daast-asset.json",
   "title": "DAAST Asset",
   "description": "DAAST (Digital Audio Ad Serving Template) tag for third-party audio ad serving",
   "type": "object",
@@ -11,7 +11,7 @@
       "description": "Discriminator identifying this as a DAAST asset. See /schemas/creative/asset-types for the registry."
     },
     "daast_version": {
-      "$ref": "/schemas/3.1.29/enums/daast-version.json",
+      "$ref": "/schemas/3.1.31/enums/daast-version.json",
       "description": "DAAST specification version"
     },
     "duration_ms": {
@@ -22,7 +22,7 @@
     "tracking_events": {
       "type": "array",
       "items": {
-        "$ref": "/schemas/3.1.29/enums/daast-tracking-event.json"
+        "$ref": "/schemas/3.1.31/enums/daast-tracking-event.json"
       },
       "description": "Tracking events supported by this DAAST tag"
     },
@@ -37,7 +37,7 @@
       "x-accessibility": true
     },
     "provenance": {
-      "$ref": "/schemas/3.1.29/core/provenance.json",
+      "$ref": "/schemas/3.1.31/core/provenance.json",
       "description": "Provenance metadata for this asset, overrides manifest-level provenance"
     }
   },
@@ -53,7 +53,7 @@
           "description": "Discriminator indicating DAAST is delivered via URL endpoint"
         },
         "url": {
-          "$ref": "/schemas/3.1.29/core/macro-bearing-url.json",
+          "$ref": "/schemas/3.1.31/core/macro-bearing-url.json",
           "description": "URL endpoint that returns DAAST XML. May carry unsubstituted ad-server macros — DAAST/VAST-style `[MACRO]`, `${MACRO}`, and `%%MACRO%%` placeholders are accepted as-is; buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time."
         }
       },

package/dist/lib/schemas-data/3.1/core/assets/daast-tracker-asset.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/core/assets/daast-tracker-asset.json",
+  "$id": "/schemas/3.1.31/core/assets/daast-tracker-asset.json",
   "title": "DAAST Tracker Asset",
   "description": "A single tracker URL bound to a DAAST `TrackingEvents` event. Audio-side analogue of vast-tracker-asset. The `Impression` URL MUST be modeled as a `url` asset with `url_type: \"tracker_pixel\"`, not as a daast_tracker with `daast_event: \"impression\"`.",
   "type": "object",
@@ -13,7 +13,7 @@
     "daast_event": {
       "allOf": [
         {
-          "$ref": "/schemas/3.1.29/enums/daast-tracking-event.json"
+          "$ref": "/schemas/3.1.31/enums/daast-tracking-event.json"
         },
         {
           "not": {
@@ -34,7 +34,7 @@
       "description": "The DAAST tracking event this URL fires on. MUST NOT be `impression` (model as `url` asset with `url_type: \"tracker_pixel\"`), `clickTracking` / `customClick` (click-tracking trackers go on their own URL asset), `error`, or any of the `ViewableImpression`-element children (`viewable`, `notViewable`, `viewUndetermined`, `measurableImpression`, `viewableImpression`)."
     },
     "url": {
-      "$ref": "/schemas/3.1.29/core/macro-bearing-url.json",
+      "$ref": "/schemas/3.1.31/core/macro-bearing-url.json",
       "description": "Tracker URL that fires when `daast_event` occurs. May carry AdCP universal macros; the sales agent or ad server URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx."
     },
     "offset": {
@@ -52,7 +52,7 @@
       "description": "Which DAAST creative element this tracker scopes to — `linear` for `<Linear>/<TrackingEvents>` (DAAST 1.1 §3.2.1.7), `companion` for `<CompanionAds>/<Companion>/<TrackingEvents>` (DAAST 1.1 §3.2.2.7, where the only valid event is `creativeView`). DAAST has no `<NonLinearAds>` element. Defaults to `linear`. Sales agents use this to place the tracker in the correct location during DAAST assembly."
     },
     "provenance": {
-      "$ref": "/schemas/3.1.29/core/provenance.json",
+      "$ref": "/schemas/3.1.31/core/provenance.json",
       "description": "Provenance metadata for this asset, overrides manifest-level provenance."
     }
   },

package/dist/lib/schemas-data/3.1/core/assets/html-asset.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/core/assets/html-asset.json",
+  "$id": "/schemas/3.1.31/core/assets/html-asset.json",
   "title": "HTML Asset",
   "description": "Inline HTML content asset. For URL-delivered HTML5 banner bundles, use the zip asset type instead. For single-URL iframe-rendered tag references, use the url asset type with an appropriate url_type.",
   "type": "object",
@@ -42,7 +42,7 @@
       }
     },
     "provenance": {
-      "$ref": "/schemas/3.1.29/core/provenance.json",
+      "$ref": "/schemas/3.1.31/core/provenance.json",
       "description": "Provenance metadata for this asset, overrides manifest-level provenance"
     }
   },

package/dist/lib/schemas-data/3.1/core/assets/image-asset.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/core/assets/image-asset.json",
+  "$id": "/schemas/3.1.31/core/assets/image-asset.json",
   "title": "Image Asset",
   "description": "Image asset with URL and dimensions",
   "type": "object",
@@ -35,7 +35,7 @@
       "x-accessibility": true
     },
     "provenance": {
-      "$ref": "/schemas/3.1.29/core/provenance.json",
+      "$ref": "/schemas/3.1.31/core/provenance.json",
       "description": "Provenance metadata for this asset, overrides manifest-level provenance"
     }
   },

package/dist/lib/schemas-data/3.1/core/assets/javascript-asset.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/core/assets/javascript-asset.json",
+  "$id": "/schemas/3.1.31/core/assets/javascript-asset.json",
   "title": "JavaScript Asset",
   "description": "Inline JavaScript content asset. For URL-delivered third-party tag scripts, use the url asset type with url_type 'tracker_script'. For HTML5 banner bundles that include JavaScript, use the zip asset type.",
   "type": "object",
@@ -15,7 +15,7 @@
       "description": "JavaScript content"
     },
     "module_type": {
-      "$ref": "/schemas/3.1.29/enums/javascript-module-type.json",
+      "$ref": "/schemas/3.1.31/enums/javascript-module-type.json",
       "description": "JavaScript module type"
     },
     "accessibility": {
@@ -42,7 +42,7 @@
       }
     },
     "provenance": {
-      "$ref": "/schemas/3.1.29/core/provenance.json",
+      "$ref": "/schemas/3.1.31/core/provenance.json",
       "description": "Provenance metadata for this asset, overrides manifest-level provenance"
     }
   },

package/dist/lib/schemas-data/3.1/core/assets/markdown-asset.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/core/assets/markdown-asset.json",
+  "$id": "/schemas/3.1.31/core/assets/markdown-asset.json",
   "title": "Markdown Asset",
   "description": "Markdown-formatted text content following CommonMark specification",
   "type": "object",
@@ -19,7 +19,7 @@
       "description": "Language code (e.g., 'en', 'es', 'fr')"
     },
     "markdown_flavor": {
-      "$ref": "/schemas/3.1.29/enums/markdown-flavor.json",
+      "$ref": "/schemas/3.1.31/enums/markdown-flavor.json",
       "default": "commonmark",
       "description": "Markdown flavor used. CommonMark for strict compatibility, GFM for tables/task lists/strikethrough."
     },

package/dist/lib/schemas-data/3.1/core/assets/pixel-tracker-asset.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/core/assets/pixel-tracker-asset.json",
+  "$id": "/schemas/3.1.31/core/assets/pixel-tracker-asset.json",
   "title": "Pixel Tracker Asset",
   "description": "A single renderer-fired HTTP tracker URL — image pixel or JavaScript include — bound to a measurement event (impression, viewability, click, custom). Generic web-pixel tracker primitive applicable to any web-rendered canonical format (image, html5, image_carousel, responsive_creative, sponsored_placement, native_*, plus the non-VAST/DAAST events of video_hosted and audio_hosted). The buyer's measurement vendor declares the tracker URL; the seller's renderer fires it at serve time without buyer-side involvement.\n\nThe discriminated-union shape and event/method enums are formalized in IAB OpenRTB Native 1.2 (`imptrackers[]` / `jstracker` / `eventtrackers[]` / `link.clicktrackers[]`); the same shape applies cleanly to image banners, html5, carousels, and any other format whose renderer fires HTTP pixels for measurement. The name `pixel_tracker` mirrors the industry's existing 'tracker pixel' terminology (already used in `url_type: \"tracker_pixel\"`) and applies equally to `method: img` and `method: js` (a JS include is still a measurement-pixel hop in vendor parlance).\n\n**Scope boundary (normative).** `pixel_tracker` covers RENDERER-FIRED trackers — measurement events that the ad's serving template invokes when the user sees, views, or clicks the creative. Conversion pixels that fire on the advertiser's site after the click (Meta Pixel, GA4 server-side, custom postbacks) MUST be modeled via `sync_event_sources` / `event_log` — they are campaign-scoped, not creative-asset-scoped. See `docs/creative/canonical-formats.mdx#what-format_kind-is-not-for`.\n\n**Format-specific tracker primitives.** Formats whose wire shape embeds tracker URLs in a format-specific structure use dedicated asset types instead:\n- `video_vast` → `vast_tracker` (VAST `<TrackingEvents>`: start, quartiles, complete, pause, mute)\n- `audio_daast` → `daast_tracker` (DAAST `<TrackingEvents>` parity)\n- `display_tag` → opaque (third-party server fires its own trackers)\n\nAll other web-rendered canonicals use `pixel_tracker`.\n\nMaps to IAB OpenRTB Native 1.2 / Dynamic Native Ads API tracker objects:\n- `imptrackers[]` → one `pixel_tracker` per entry with `event: impression`, `method: img`\n- `jstracker` → one `pixel_tracker` with `event: impression`, `method: js`\n- `eventtrackers[]` → one `pixel_tracker` per entry, `event` mapped from the IAB event enum\n- `link.clicktrackers[]` → one `pixel_tracker` per entry with `event: click`, `method: img` (click destinations live on `landing_page_url` slot)\n\n**Bidirectional v1↔v2 mapping (normative for SDK auto-negotiation).** A 3.1 buyer SDK talking to a 3.0.x seller MUST downgrade `pixel_tracker` to the v1 `{asset_type: url, url_type: tracker_pixel}` shape. The URL still emits on the wire; what's lost depends on the original event/method. A 3.1 SDK reading a v1 manifest MUST upgrade `{asset_type: url, url_type: tracker_pixel}` to `pixel_tracker` by inferring event/method from the v1 `asset_id`. Both directions are lossy-with-advisory; SDKs MUST emit the appropriate error code so consumers can see what was inferred or dropped.\n\n**v2 → v1 downgrade table:**\n| pixel_tracker source | v1 emit | Lost fields | Error code |\n|---|---|---|---|\n| `{event: impression, method: img, url}` | `{url_type: tracker_pixel, asset_id: impression_tracker, url}` | none | (no advisory) |\n| `{event: viewable_mrc_50, method: img, url}` | `{url_type: tracker_pixel, asset_id: viewability_tracker, url}` | event variant | `PIXEL_TRACKER_LOSSY_DOWNGRADE` |\n| `{event: viewable_mrc_100, method: img, url}` | same shape | event variant | `PIXEL_TRACKER_LOSSY_DOWNGRADE` |\n| `{event: viewable_video_50, method: img, url}` | same shape | event variant | `PIXEL_TRACKER_LOSSY_DOWNGRADE` |\n| `{event: audible_video_complete, method: img, url}` | same shape | event variant | `PIXEL_TRACKER_LOSSY_DOWNGRADE` |\n| `{event: click, method: img, url}` | `{url_type: tracker_pixel, asset_id: click_tracker, url}` | none meaningful | (no advisory) |\n| `{event: custom, custom_event_name: X, ...}` | `{url_type: tracker_pixel, asset_id: impression_tracker, url}` (defaults to impression timing) | custom event timing | `PIXEL_TRACKER_LOSSY_DOWNGRADE` |\n| `{method: js, any event, url}` | same shape with `url_type: tracker_pixel` | JS execution context — URL is hit via GET (counter increments), but JS body doesn't execute (OMID-style verification, viewability observers, cross-domain cookie setters won't fire) | `PIXEL_TRACKER_LOSSY_DOWNGRADE` |\n\n**v1 → v2 upgrade table (inferred — SDK has no explicit event/method):**\n| v1 source (asset_id) | Inferred pixel_tracker | Inference basis |\n|---|---|---|\n| `impression_tracker` | `{event: impression, method: img}` | asset_id convention |\n| `viewability_tracker` | `{event: viewable_mrc_50, method: img}` | asset_id convention + most-common default (50% is the dominant variant in v1 catalogs) |\n| `click_tracker` | `{event: click, method: img}` | asset_id convention |\n| `<other asset_id>` | `{event: custom, custom_event_name: <original asset_id>, method: img}` | fallback — preserves the original asset_id as the custom name |\n\nAll v1→v2 upgrades surface `PIXEL_TRACKER_UPGRADE_INFERRED` so consumers can see that event/method were inferred rather than explicitly declared.",
   "type": "object",
@@ -33,7 +33,7 @@
       "description": "How the tracker URL is invoked at serve time:\n- `img` — fired as an image pixel (HTTP GET with `<img>`-like semantics; no JS execution)\n- `js` — fired as a script include (renderer evaluates the URL's response as JavaScript)\n\nMatches IAB OpenRTB Native 1.2 method enum (1=img, 2=js). `js` MUST only be used by sellers whose renderer supports JavaScript trackers; sellers without JS-tracker support MUST reject `method: js` declarations at sync_creatives time with `CREATIVE_REJECTED` carrying the reason."
     },
     "url": {
-      "$ref": "/schemas/3.1.29/core/macro-bearing-url.json",
+      "$ref": "/schemas/3.1.31/core/macro-bearing-url.json",
       "description": "Tracker URL fired when `event` occurs. May carry AdCP universal macros (e.g., `{MEDIA_BUY_ID}`, `{CREATIVE_ID}`, `{CACHEBUSTER}`); the seller's renderer URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx."
     },
     "custom_event_name": {
@@ -41,7 +41,7 @@
       "description": "REQUIRED when `event` is `custom`; otherwise MUST be absent. Adopter-defined event name. Sellers without registered handling for a given custom_event_name MUST silently no-op (do not fire) rather than reject — custom events are forward-compatible probes."
     },
     "provenance": {
-      "$ref": "/schemas/3.1.29/core/provenance.json",
+      "$ref": "/schemas/3.1.31/core/provenance.json",
       "description": "Provenance metadata for this asset, overrides manifest-level provenance."
     }
   },

package/dist/lib/schemas-data/3.1/core/assets/published-post-asset.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/core/assets/published-post-asset.json",
+  "$id": "/schemas/3.1.31/core/assets/published-post-asset.json",
   "title": "Published Post Asset",
   "description": "Reference to an already-published post on a publisher, creator, or social platform. The buyer supplies a reference to the existing post; the seller resolves, authorizes, reviews, and serves the referenced post according to the target product's format declaration. This asset is for post references, not uploaded bytes and not catalog rows.",
   "type": "object",
@@ -91,7 +91,7 @@
       "additionalProperties": true
     },
     "provenance": {
-      "$ref": "/schemas/3.1.29/core/provenance.json",
+      "$ref": "/schemas/3.1.31/core/provenance.json",
       "description": "Provenance metadata for this reference asset, overrides manifest-level provenance."
     }
   },

package/dist/lib/schemas-data/3.1/core/assets/text-asset.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/core/assets/text-asset.json",
+  "$id": "/schemas/3.1.31/core/assets/text-asset.json",
   "title": "Text Asset",
   "description": "Text content asset",
   "type": "object",
@@ -19,7 +19,7 @@
       "description": "Language code (e.g., 'en', 'es', 'fr')"
     },
     "provenance": {
-      "$ref": "/schemas/3.1.29/core/provenance.json",
+      "$ref": "/schemas/3.1.31/core/provenance.json",
       "description": "Provenance metadata for this asset, overrides manifest-level provenance"
     }
   },

package/dist/lib/schemas-data/3.1/core/assets/url-asset.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/core/assets/url-asset.json",
+  "$id": "/schemas/3.1.31/core/assets/url-asset.json",
   "title": "URL Asset",
   "$comment": "Fallback table is also rendered in docs/creative/asset-types.mdx (URL Asset section). Keep the two in sync — schema description is the normative source for conformance tools; mdx is the human-readable copy.",
   "description": "URL reference asset. `url_type` declares the mechanism a receiver uses to invoke the URL (clickthrough vs. tracker_pixel vs. tracker_script) and is distinct from the URL's purpose, which the format declares in `url-asset-requirements.role` (clickthrough, landing_page, impression_tracker, click_tracker, viewability_tracker, third_party_tracker). Senders SHOULD include `url_type` on every URL asset. When `url_type` is absent, receivers SHOULD fall back to the format's `url-asset-requirements.role` per this mapping: clickthrough/landing_page → `clickthrough`; impression_tracker/click_tracker → `tracker_pixel`; viewability_tracker → `tracker_script` (OMID and equivalent verification SDKs require a <script> tag — firing them as a pixel produces no measurement); third_party_tracker → no safe fallback (mechanism is integration-specific — DV/IAS ship both pixel and script forms — receivers MAY reject or warn). When neither `url_type` nor a format-side `role` is available, receivers MUST NOT silently pick a mechanism; they SHOULD reject the manifest. Note: VAST/DAAST tag URLs are not URL assets — use `asset_type: \"vast\"` (or the dedicated tracker types pending RFC #2915), not `asset_type: \"url\"` with a tracker_pixel mechanism.",
@@ -12,11 +12,11 @@
       "description": "Discriminator identifying this as a URL asset. See /schemas/creative/asset-types for the registry."
     },
     "url": {
-      "$ref": "/schemas/3.1.29/core/macro-bearing-url.json",
+      "$ref": "/schemas/3.1.31/core/macro-bearing-url.json",
       "description": "URL reference. May be a plain URI or an RFC 6570 URI template carrying AdCP universal macros (e.g., `{SKU}`, `{MEDIA_BUY_ID}`). Buyers MUST NOT pre-encode macro braces at sync time; the ad server URL-encodes substituted values at impression time. See docs/creative/universal-macros.mdx."
     },
     "url_type": {
-      "$ref": "/schemas/3.1.29/enums/url-asset-type.json",
+      "$ref": "/schemas/3.1.31/enums/url-asset-type.json",
       "description": "Mechanism a receiver uses to invoke this URL (distinct from purpose, which lives in `url-asset-requirements.role`): `clickthrough` for user click destination (landing page), `tracker_pixel` for impression/event tracking via HTTP request (fires GET, expects pixel/204 response), `tracker_script` for measurement SDKs that must load as a <script> tag (OMID verification, native event trackers using method:2). SHOULD be present on every URL asset; senders that omit it force the receiver into the role-based fallback described in this schema's top-level description."
     },
     "description": {
@@ -24,7 +24,7 @@
       "description": "Description of what this URL points to"
     },
     "provenance": {
-      "$ref": "/schemas/3.1.29/core/provenance.json",
+      "$ref": "/schemas/3.1.31/core/provenance.json",
       "description": "Provenance metadata for this asset, overrides manifest-level provenance"
     }
   },

package/dist/lib/schemas-data/3.1/core/assets/vast-asset.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/core/assets/vast-asset.json",
+  "$id": "/schemas/3.1.31/core/assets/vast-asset.json",
   "title": "VAST Asset",
   "description": "VAST (Video Ad Serving Template) tag for third-party video ad serving. Unlike the hosted `video` asset, a VAST tag carries no `width`/`height`: a VAST response can return multiple renditions of differing dimensions, and the player selects one per device at serve time, so there is no single width/height for the ad. Dimensional, duration, and codec *constraints* for a placement live on the format/requirements layer, not on this asset.",
   "type": "object",
@@ -11,7 +11,7 @@
       "description": "Discriminator identifying this as a VAST asset. See /schemas/creative/asset-types for the registry."
     },
     "vast_version": {
-      "$ref": "/schemas/3.1.29/enums/vast-version.json",
+      "$ref": "/schemas/3.1.31/enums/vast-version.json",
       "description": "VAST specification version"
     },
     "vpaid_enabled": {
@@ -26,7 +26,7 @@
     "tracking_events": {
       "type": "array",
       "items": {
-        "$ref": "/schemas/3.1.29/enums/vast-tracking-event.json"
+        "$ref": "/schemas/3.1.31/enums/vast-tracking-event.json"
       },
       "description": "Tracking events supported by this VAST tag"
     },
@@ -43,7 +43,7 @@
       "x-accessibility": true
     },
     "provenance": {
-      "$ref": "/schemas/3.1.29/core/provenance.json",
+      "$ref": "/schemas/3.1.31/core/provenance.json",
       "description": "Provenance metadata for this asset, overrides manifest-level provenance"
     }
   },
@@ -59,7 +59,7 @@
           "description": "Discriminator indicating VAST is delivered via URL endpoint"
         },
         "url": {
-          "$ref": "/schemas/3.1.29/core/macro-bearing-url.json",
+          "$ref": "/schemas/3.1.31/core/macro-bearing-url.json",
           "description": "URL endpoint that returns VAST XML. May carry unsubstituted ad-server macros — VAST-style `[MACRO]`, `${MACRO}`, and `%%MACRO%%` placeholders are accepted as-is; buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time."
         }
       },