@adcp/sdk 13.0.1 → 13.0.2

package/dist/lib/schemas-data/3.1/core/creative-manifest.json

@@ -1,20 +1,20 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/core/creative-manifest.json",
+  "$id": "/schemas/3.1.20/core/creative-manifest.json",
   "title": "Creative Manifest",
   "description": "Complete specification of a creative: format identification + assets. A manifest carries EITHER a legacy `format_id` (structured `{agent_url, id}` reference to a named format) OR a 3.1+ `format_kind` (the canonical format name the manifest targets, paired with optional `format_option_ref` for routing when a product's `format_options` contains multiple declarations sharing the same `format_kind`). Mutually exclusive — see the `oneOf` at the schema root. Everything the creative needs — images, text, briefs, catalogs — lives in the assets map, declared by the matching format declaration. Each asset is typed according to its asset_type from the format specification.",
   "type": "object",
   "properties": {
     "format_id": {
-      "$ref": "/schemas/3.1.15/core/format-id.json",
+      "$ref": "/schemas/3.1.20/core/format-id.json",
       "description": "Legacy named-format path. Always a structured object {agent_url, id} — never a plain string. Format identifier this manifest is for. Can be a template format (id only) or a deterministic format (id + dimensions/duration). For dimension-specific creatives, include width/height in the format_id to create a unique identifier (e.g., {id: 'display_static', width: 300, height: 250}). Mutually exclusive with `format_kind`."
     },
     "format_kind": {
-      "$ref": "/schemas/3.1.15/core/canonical-format-kind.json",
+      "$ref": "/schemas/3.1.20/core/canonical-format-kind.json",
       "description": "3.1+ canonical-format path. The canonical format name this manifest targets (e.g., `image`, `video_hosted`, `audio_daast`, `sponsored_placement`). Selects which canonical the seller validates the manifest's assets against. Mutually exclusive with `format_id`."
     },
     "format_option_ref": {
-      "$ref": "/schemas/3.1.15/core/format-option-ref.json",
+      "$ref": "/schemas/3.1.20/core/format-option-ref.json",
       "description": "3.1+ format-option path, optional. Structured format option reference matching one of the target product's `format_options[]` declarations. Publisher-catalog-backed options match by `{ scope: \"publisher\", publisher_domain, format_option_id }`; product-local options match by `{ scope: \"product\", format_option_id }`. Required when the target product carries multiple `format_options` entries sharing the same `format_kind`; optional when `format_kind` alone routes the manifest to a single declaration. Product-scoped refs require an enclosing target product/package context."
     },
     "assets": {
@@ -24,12 +24,12 @@
         "^[a-z0-9_]+$": {
           "oneOf": [
             {
-              "$ref": "/schemas/3.1.15/core/assets/asset-union.json"
+              "$ref": "/schemas/3.1.20/core/assets/asset-union.json"
             },
             {
               "type": "array",
               "items": {
-                "$ref": "/schemas/3.1.15/core/assets/asset-union.json"
+                "$ref": "/schemas/3.1.20/core/assets/asset-union.json"
               },
               "minItems": 1
             }
@@ -39,30 +39,30 @@
       "additionalProperties": true
     },
     "brand": {
-      "$ref": "/schemas/3.1.15/core/brand-ref.json",
+      "$ref": "/schemas/3.1.20/core/brand-ref.json",
       "description": "Brand identity reference (BrandRef — `domain` plus optional `brand_id` for house-of-brands; plus optional inline `brand_kit_override` for per-creative tweaks where brand.json is missing/stale). When present, the seller pulls brand context (logos, colors, voice, taglines) from the brand's brand.json automatically; any `brand_kit_override` fields on the BrandRef take precedence. v2 formats no longer redeclare brand_logo / brand_colors / brand_voice as explicit slots — brand identity is implicit context."
     },
     "rights": {
       "type": "array",
       "description": "Rights constraints attached to this creative. Each entry represents constraints from a single rights holder. A creative may combine multiple rights constraints (e.g., talent likeness + music license). For v1, rights constraints are informational metadata — the buyer/orchestrator manages creative lifecycle against these terms.",
       "items": {
-        "$ref": "/schemas/3.1.15/core/rights-constraint.json"
+        "$ref": "/schemas/3.1.20/core/rights-constraint.json"
       }
     },
     "industry_identifiers": {
       "type": "array",
       "description": "Industry-standard or market-specific identifiers for this specific manifest (e.g., Ad-ID, ISCI, Clearcast clock number, IDcrea). When present, overrides creative-level identifiers. Use when different format versions of the same source creative have distinct traffic identifiers (e.g., the :15 and :30 cuts, or separate TV and radio versions). Add a PR to extend creative-identifier-type when another shared identifier scheme needs first-class support.",
       "items": {
-        "$ref": "/schemas/3.1.15/core/industry-identifier.json"
+        "$ref": "/schemas/3.1.20/core/industry-identifier.json"
       },
       "uniqueItems": true
     },
     "provenance": {
-      "$ref": "/schemas/3.1.15/core/provenance.json",
+      "$ref": "/schemas/3.1.20/core/provenance.json",
       "description": "Provenance metadata for this creative manifest. Serves as the default provenance for all assets in this manifest. An asset with its own provenance replaces this object entirely (no field-level merging)."
     },
     "ext": {
-      "$ref": "/schemas/3.1.15/core/ext.json"
+      "$ref": "/schemas/3.1.20/core/ext.json"
     }
   },
   "required": [

package/dist/lib/schemas-data/3.1/core/creative-policy.json

@@ -1,16 +1,16 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/core/creative-policy.json",
+  "$id": "/schemas/3.1.20/core/creative-policy.json",
   "title": "Creative Policy",
   "description": "Creative requirements and restrictions for a product",
   "type": "object",
   "properties": {
     "co_branding": {
-      "$ref": "/schemas/3.1.15/enums/co-branding-requirement.json",
+      "$ref": "/schemas/3.1.20/enums/co-branding-requirement.json",
       "description": "Co-branding requirement"
     },
     "landing_page": {
-      "$ref": "/schemas/3.1.15/enums/landing-page-requirement.json",
+      "$ref": "/schemas/3.1.20/enums/landing-page-requirement.json",
       "description": "Landing page requirements"
     },
     "templates_available": {

package/dist/lib/schemas-data/3.1/core/creative-variable.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/core/creative-variable.json",
+  "$id": "/schemas/3.1.20/core/creative-variable.json",
   "title": "Creative Variable",
   "description": "A dynamic content variable (DCO slot) on a creative. Variables represent content that can change at serve time — headlines, images, product data, etc.",
   "type": "object",

package/dist/lib/schemas-data/3.1/core/creative-variant.json

@@ -1,12 +1,12 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/core/creative-variant.json",
+  "$id": "/schemas/3.1.20/core/creative-variant.json",
   "title": "Creative Variant",
   "description": "A specific execution variant of a creative with delivery metrics. For catalog-driven packages, each catalog item rendered as a distinct ad execution is a variant — the variant's manifest includes the catalog reference with the specific item rendered. For asset group optimization, represents one combination of assets the platform selected. For generative creative, represents a platform-generated variant. For standard creatives, maps 1:1 with the creative itself.",
   "type": "object",
   "allOf": [
     {
-      "$ref": "/schemas/3.1.15/core/delivery-metrics.json"
+      "$ref": "/schemas/3.1.20/core/delivery-metrics.json"
     },
     {
       "properties": {
@@ -15,7 +15,7 @@
           "description": "Platform-assigned identifier for this variant"
         },
         "manifest": {
-          "$ref": "/schemas/3.1.15/core/creative-manifest.json",
+          "$ref": "/schemas/3.1.20/core/creative-manifest.json",
           "description": "The rendered creative manifest for this variant — the actual output that was served, not the input assets. Contains format_id and the resolved assets (specific headline, image, video, etc. the platform selected or generated). For Tier 2, shows which asset combination was picked. For Tier 3, contains the generated assets which may differ entirely from the input brand identity. Pass to preview_creative to re-render."
         },
         "generation_context": {
@@ -31,7 +31,7 @@
               "description": "Reference to the content-standards artifact that provided the generation context. Links this variant to the specific piece of content (article, video, podcast segment, etc.) where the ad was placed.",
               "properties": {
                 "property_id": {
-                  "$ref": "/schemas/3.1.15/core/identifier.json",
+                  "$ref": "/schemas/3.1.20/core/identifier.json",
                   "description": "Property where the artifact appears"
                 },
                 "artifact_id": {
@@ -46,7 +46,7 @@
               "additionalProperties": false
             },
             "ext": {
-              "$ref": "/schemas/3.1.15/core/ext.json"
+              "$ref": "/schemas/3.1.20/core/ext.json"
             }
           },
           "additionalProperties": true

package/dist/lib/schemas-data/3.1/core/data-provider-signal-selector.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/core/data-provider-signal-selector.json",
+  "$id": "/schemas/3.1.20/core/data-provider-signal-selector.json",
   "title": "Data Provider Signal Selector",
   "description": "Selects signals from a data provider's adagents.json signals[]. Used for product definitions and agent authorization. Supports three selection patterns: all signals, specific IDs, or by tags.",
   "x-adcp-hoist": true,

package/dist/lib/schemas-data/3.1/core/date-range.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/core/date-range.json",
+  "$id": "/schemas/3.1.20/core/date-range.json",
   "title": "Date Range",
   "description": "A date range with inclusive start and end dates (ISO 8601 calendar dates). Used for billing periods, flight dates, and other calendar-day boundaries.",
   "type": "object",

package/dist/lib/schemas-data/3.1/core/datetime-range.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/core/datetime-range.json",
+  "$id": "/schemas/3.1.20/core/datetime-range.json",
   "title": "Datetime Range",
   "description": "A datetime range with inclusive start and end timestamps (ISO 8601 with timezone). Used for measurement windows, reporting periods, and other sub-day precision boundaries.",
   "type": "object",

package/dist/lib/schemas-data/3.1/core/daypart-target.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/core/daypart-target.json",
+  "$id": "/schemas/3.1.20/core/daypart-target.json",
   "title": "Daypart Target",
   "description": "A time window for daypart targeting. Specifies days of week and an hour range. start_hour is inclusive, end_hour is exclusive (e.g., 6-10 = 6:00am to 10:00am). Follows the Google Ads AdScheduleInfo / DV360 DayPartTargeting pattern.",
   "type": "object",
@@ -9,7 +9,7 @@
       "type": "array",
       "description": "Days of week this window applies to. Use multiple days for compact targeting (e.g., monday-friday in one object).",
       "items": {
-        "$ref": "/schemas/3.1.15/enums/day-of-week.json"
+        "$ref": "/schemas/3.1.20/enums/day-of-week.json"
       },
       "minItems": 1
     },

package/dist/lib/schemas-data/3.1/core/deadline-policy.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/core/deadline-policy.json",
+  "$id": "/schemas/3.1.20/core/deadline-policy.json",
   "title": "Deadline Policy",
   "description": "Default deadline rules for installments that do not declare their own deadlines. Agents compute absolute deadlines from the installment's scheduled_at and these lead times. Installments with explicit deadlines override this policy. booking_lead_days SHOULD be >= cancellation_lead_days (bookings close before cancellation window closes).",
   "type": "object",

package/dist/lib/schemas-data/3.1/core/delivery-forecast.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/core/delivery-forecast.json",
+  "$id": "/schemas/3.1.20/core/delivery-forecast.json",
   "title": "Delivery Forecast",
   "description": "Forecasted delivery metrics for a proposal or product allocation. Publishers attach points to help buyers evaluate expected campaign performance before purchase.",
   "type": "object",
@@ -9,16 +9,16 @@
       "type": "array",
       "description": "Forecasted delivery data points. For spend curves (default), points at ascending budget levels show how metrics scale with spend. For availability forecasts, points represent total available inventory independent of budget. See forecast_range_unit for interpretation.",
       "items": {
-        "$ref": "/schemas/3.1.15/core/forecast-point.json"
+        "$ref": "/schemas/3.1.20/core/forecast-point.json"
       },
       "minItems": 1
     },
     "forecast_range_unit": {
-      "$ref": "/schemas/3.1.15/enums/forecast-range-unit.json",
+      "$ref": "/schemas/3.1.20/enums/forecast-range-unit.json",
       "description": "How to interpret the points array. 'spend' (default when omitted): points at ascending budget levels. 'availability': total available inventory, budget omitted. 'reach_freq': points at ascending reach/frequency targets. 'weekly'/'daily': metrics are per-period values. 'clicks'/'conversions': points at ascending outcome targets. 'package': each point is a distinct inventory package."
     },
     "method": {
-      "$ref": "/schemas/3.1.15/enums/forecast-method.json",
+      "$ref": "/schemas/3.1.20/enums/forecast-method.json",
       "description": "Method used to produce this forecast"
     },
     "currency": {
@@ -26,7 +26,7 @@
       "description": "ISO 4217 currency code for monetary values in this forecast (spend, budget)"
     },
     "demographic_system": {
-      "$ref": "/schemas/3.1.15/enums/demographic-system.json",
+      "$ref": "/schemas/3.1.20/enums/demographic-system.json",
       "description": "Measurement system for the demographic field. Ensures buyer and seller agree on demographic notation."
     },
     "demographic": {
@@ -60,7 +60,7 @@
       ]
     },
     "reach_unit": {
-      "$ref": "/schemas/3.1.15/enums/reach-unit.json",
+      "$ref": "/schemas/3.1.20/enums/reach-unit.json",
       "description": "Unit of measurement for reach and audience_size metrics in this forecast. Required for cross-channel forecast comparison."
     },
     "generated_at": {
@@ -74,7 +74,7 @@
       "description": "When this forecast expires. After this time, the forecast should be refreshed. Forecast expiry does not affect proposal executability."
     },
     "ext": {
-      "$ref": "/schemas/3.1.15/core/ext.json"
+      "$ref": "/schemas/3.1.20/core/ext.json"
     }
   },
   "required": [

package/dist/lib/schemas-data/3.1/core/delivery-metric-aggregate.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/core/delivery-metric-aggregate.json",
+  "$id": "/schemas/3.1.20/core/delivery-metric-aggregate.json",
   "title": "Delivery Metric Aggregate",
   "description": "One cross-buy delivery aggregate partitioned by metric scope and qualifier. Row-symmetric with `package.committed_metrics` and delivery `missing_metrics` so buyers can reconcile by `(scope, metric_id, qualifier)`.",
   "type": "object",
@@ -16,7 +16,7 @@
           "description": "Standard metric from the closed `available-metric.json` enum."
         },
         "metric_id": {
-          "$ref": "/schemas/3.1.15/enums/available-metric.json",
+          "$ref": "/schemas/3.1.20/enums/available-metric.json",
           "description": "Identifier for the standard metric."
         },
         "qualifier": {
@@ -24,23 +24,23 @@
           "description": "Qualifier keys disambiguating this row from sibling rows under the same `metric_id`. Symmetric with `committed_metrics.qualifier` today; expected to diverge in future minors as transparency disclosures buyers don't commit to ship delivery-only. Closed (`additionalProperties: false`) — new qualifier keys ship explicitly.",
           "properties": {
             "viewability_standard": {
-              "$ref": "/schemas/3.1.15/enums/viewability-standard.json",
+              "$ref": "/schemas/3.1.20/enums/viewability-standard.json",
               "description": "Viewability standard under which this row was measured. MRC and GroupM define materially different thresholds; never sum across standards."
             },
             "completion_source": {
-              "$ref": "/schemas/3.1.15/enums/completion-source.json",
+              "$ref": "/schemas/3.1.20/enums/completion-source.json",
               "description": "Source of `completion_rate` attestation for this row — `seller_attested` from player/ad server, `vendor_attested` from a third-party measurement vendor. The two paths can yield different rates; never sum across sources."
             },
             "attribution_methodology": {
-              "$ref": "/schemas/3.1.15/enums/attribution-methodology.json",
+              "$ref": "/schemas/3.1.20/enums/attribution-methodology.json",
               "description": "Attribution methodology under which this outcome row was computed (`deterministic_purchase`, `probabilistic`, `panel_based`, `modeled`). Outcome metrics measured under different methodologies represent materially different numbers; never sum across methodologies."
             },
             "attribution_window": {
-              "$ref": "/schemas/3.1.15/core/duration.json",
+              "$ref": "/schemas/3.1.20/core/duration.json",
               "description": "Attribution window for this outcome row. Object-valued duration (`{interval, unit}`), not a shorthand string. Outcome metrics measured over different windows represent the same metric over different time periods; the partition keeps them as separate rows so buyers don't accidentally aggregate."
             },
             "lift_dimension": {
-              "$ref": "/schemas/3.1.15/enums/lift-dimension.json",
+              "$ref": "/schemas/3.1.20/enums/lift-dimension.json",
               "description": "Brand-lift dimension this row represents (awareness, consideration, favorability, purchase intent, or ad recall). Required when `metric_id` is `brand_lift`. Each dimension is a separate surveyed outcome with its own sample size and confidence interval; never sum across dimensions."
             }
           },
@@ -168,11 +168,11 @@
           "description": "Vendor-defined metric, identified by the tuple `(vendor, metric_id)`."
         },
         "vendor": {
-          "$ref": "/schemas/3.1.15/core/brand-ref.json",
+          "$ref": "/schemas/3.1.20/core/brand-ref.json",
           "description": "Vendor that defines and computes this metric. The vendor's `brand.json` `agents[type='measurement']` is the canonical anchor; metric definitions live on `get_adcp_capabilities.measurement.metrics[]`."
         },
         "metric_id": {
-          "$ref": "/schemas/3.1.15/core/vendor-metric-id.json",
+          "$ref": "/schemas/3.1.20/core/vendor-metric-id.json",
           "description": "Identifier for the metric within the vendor's vocabulary."
         },
         "qualifier": {

package/dist/lib/schemas-data/3.1/core/delivery-metrics.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/core/delivery-metrics.json",
+  "$id": "/schemas/3.1.20/core/delivery-metrics.json",
   "title": "Delivery Metrics",
   "description": "Standard delivery metrics that can be reported at media buy, package, or creative level",
   "type": "object",
@@ -113,7 +113,7 @@
         "type": "object",
         "properties": {
           "event_type": {
-            "$ref": "/schemas/3.1.15/enums/event-type.json",
+            "$ref": "/schemas/3.1.20/enums/event-type.json",
             "description": "The event type"
           },
           "event_source_id": {
@@ -151,7 +151,7 @@
     "reach_unit": {
       "allOf": [
         {
-          "$ref": "/schemas/3.1.15/enums/reach-unit.json"
+          "$ref": "/schemas/3.1.20/enums/reach-unit.json"
         }
       ],
       "description": "Unit of measurement for the reach field. Aligns with the reach_unit declared on optimization goals and delivery forecasts. Required when reach is present to enable cross-platform comparison."
@@ -172,7 +172,7 @@
         "period": {
           "allOf": [
             {
-              "$ref": "/schemas/3.1.15/core/duration.json"
+              "$ref": "/schemas/3.1.20/core/duration.json"
             }
           ],
           "description": "Duration of the measurement window. REQUIRED when `kind` is `period` or `rolling` — declares the snapshot length (e.g., `{\"interval\": 1, \"unit\": \"days\"}` for a daily snapshot) or the trailing-window length (e.g., `{\"interval\": 7, \"unit\": \"days\"}` for trailing-7-day rolling reach). When `kind` is `cumulative`, this field is implicit (campaign-to-date) and SHOULD be omitted."
@@ -317,7 +317,7 @@
       "description": "Viewability metrics. Viewable rate should be calculated as viewable_impressions / measurable_impressions (not total impressions), since some environments cannot measure viewability. Includes `viewed_seconds` — average in-view duration — since duration is governed by the same viewability threshold (`standard`) and shares the same `measurable_impressions` denominator. Sellers SHOULD include `standard` whenever measured viewability values are reported because MRC and GroupM rows are not interchangeable.",
       "properties": {
         "vendor": {
-          "$ref": "/schemas/3.1.15/core/brand-ref.json",
+          "$ref": "/schemas/3.1.20/core/brand-ref.json",
           "description": "Vendor that produced these viewability values. Optional but RECOMMENDED so the row is self-describing — buyer agents reading delivery in isolation can attribute the numbers without joining back to `package.committed_metrics` or `package.performance_standards`. The vendor's `brand.json` `agents[type='measurement']` is the discovery anchor; the metric definitions live on the agent's `get_adcp_capabilities.measurement.metrics[]` block. Same shape as `vendor_metric_value.vendor` for symmetry across vendor-attested surfaces."
         },
         "measurable_impressions": {
@@ -342,7 +342,7 @@
           "minimum": 0
         },
         "standard": {
-          "$ref": "/schemas/3.1.15/enums/viewability-standard.json",
+          "$ref": "/schemas/3.1.20/enums/viewability-standard.json",
           "description": "Viewability measurement standard applied to these metrics. Governs the in-view threshold for both `viewable_rate` and `viewed_seconds`."
         }
       },
@@ -411,7 +411,7 @@
         "type": "object",
         "properties": {
           "action_source": {
-            "$ref": "/schemas/3.1.15/enums/action-source.json",
+            "$ref": "/schemas/3.1.20/enums/action-source.json",
             "description": "Where the conversion occurred"
           },
           "event_source_id": {
@@ -440,7 +440,7 @@
       "type": "array",
       "description": "Reported values for vendor-defined metrics that the product's `reporting_capabilities.vendor_metrics` declared. Each entry carries the vendor (BrandRef), the metric identifier within the vendor's vocabulary, the value, optional unit, and `measurable_impressions` as the coverage denominator — vendor measurement is rarely 100% of delivered impressions, since vendors only score impressions where their SDK fires or their panel matches. When a declared vendor metric is omitted from this array, buyers infer no measurement happened (no integration). One row per `(vendor.domain, vendor.brand_id, metric_id)` per reporting period — sellers MUST de-duplicate before emission and MUST NOT emit the same vendor metric twice; buyers MAY treat duplicate rows as a seller-side conformance bug. The structured `vendor_metric_values` array is the recommended path for vendor metrics; `additionalProperties: true` on this parent object is preserved so existing free-form vendor emissions remain conformant during migration.",
       "items": {
-        "$ref": "/schemas/3.1.15/core/vendor-metric-value.json"
+        "$ref": "/schemas/3.1.20/core/vendor-metric-value.json"
       }
     }
   },

package/dist/lib/schemas-data/3.1/core/deployment.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/core/deployment.json",
+  "$id": "/schemas/3.1.20/core/deployment.json",
   "title": "Deployment",
   "description": "A signal deployment to a specific deployment target with activation status and key",
   "discriminator": {
@@ -28,7 +28,7 @@
           "description": "Whether signal is currently active on this deployment"
         },
         "activation_key": {
-          "$ref": "/schemas/3.1.15/core/activation-key.json",
+          "$ref": "/schemas/3.1.20/core/activation-key.json",
           "description": "The key to use for targeting. Only present if is_live=true AND requester has access to this deployment."
         },
         "estimated_activation_duration_minutes": {
@@ -71,7 +71,7 @@
           "description": "Whether signal is currently active on this deployment"
         },
         "activation_key": {
-          "$ref": "/schemas/3.1.15/core/activation-key.json",
+          "$ref": "/schemas/3.1.20/core/activation-key.json",
           "description": "The key to use for targeting. Only present if is_live=true AND requester has access to this deployment."
         },
         "estimated_activation_duration_minutes": {

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

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/core/destination-item.json",
+  "$id": "/schemas/3.1.20/core/destination-item.json",
   "title": "Destination Item",
   "description": "A travel destination within a destination-type catalog. Carries the location, imagery, and pricing data that platforms use for destination ads and travel remarketing. Maps to Meta destination catalogs, Google travel ads, and similar formats.",
   "type": "object",
@@ -67,7 +67,7 @@
       "description": "Destination category."
     },
     "price": {
-      "$ref": "/schemas/3.1.15/core/price.json",
+      "$ref": "/schemas/3.1.20/core/price.json",
       "description": "Starting price for a trip to this destination."
     },
     "image_url": {
@@ -98,12 +98,12 @@
       "type": "array",
       "description": "Typed creative asset pools for this destination. Uses the same OfferingAssetGroup structure as offering-type catalogs. Standard group IDs: 'images_landscape' (destination hero), 'images_vertical' (9:16 for Snap, Stories), 'images_square' (1:1). Enables formats to declare typed image requirements that map unambiguously to the right asset regardless of platform.",
       "items": {
-        "$ref": "/schemas/3.1.15/core/offering-asset-group.json"
+        "$ref": "/schemas/3.1.20/core/offering-asset-group.json"
       },
       "minItems": 1
     },
     "ext": {
-      "$ref": "/schemas/3.1.15/core/ext.json"
+      "$ref": "/schemas/3.1.20/core/ext.json"
     }
   },
   "required": [

package/dist/lib/schemas-data/3.1/core/destination.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/core/destination.json",
+  "$id": "/schemas/3.1.20/core/destination.json",
   "title": "Destination",
   "description": "A deployment target where signals can be activated (DSP, sales agent, etc.)",
   "discriminator": {

package/dist/lib/schemas-data/3.1/core/diagnostic-issue.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/core/diagnostic-issue.json",
+  "$id": "/schemas/3.1.20/core/diagnostic-issue.json",
   "title": "Diagnostic Issue",
   "description": "An actionable issue detected during a health or readiness assessment. Used by event source health and measurement readiness to surface problems and recommendations.",
   "type": "object",

package/dist/lib/schemas-data/3.1/core/downstream-connection-requirement.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/core/downstream-connection-requirement.json",
+  "$id": "/schemas/3.1.20/core/downstream-connection-requirement.json",
   "title": "Downstream Connection Requirement",
   "description": "A seller/platform-side connection or grant required by a product, format, or request. This is not the AdCP caller credential: the AdCP request is still authenticated once, and the seller uses these stored downstream connections to call a platform or service on the buyer's behalf. Use this shape for platforms that require more than one downstream grant, such as an advertiser account connection plus a publisher identity or post authorization for published-post references.",
   "type": "object",

package/dist/lib/schemas-data/3.1/core/duration.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/core/duration.json",
+  "$id": "/schemas/3.1.20/core/duration.json",
   "title": "Duration",
   "description": "A time duration expressed as an interval and unit. Used for frequency cap windows, attribution windows, reach optimization windows, time budgets, and other time-based settings. When unit is 'campaign', interval must be 1 — the window spans the full campaign flight.",
   "type": "object",

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

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/core/education-item.json",
+  "$id": "/schemas/3.1.20/core/education-item.json",
   "title": "Education Item",
   "description": "An educational program or course within an education-type catalog. Carries the program details that platforms use for education ads and student recruitment campaigns. Maps to Google DynamicEducationAsset, schema.org Course, and similar formats.",
   "type": "object",
@@ -48,7 +48,7 @@
       "description": "Difficulty or prerequisite level."
     },
     "price": {
-      "$ref": "/schemas/3.1.15/core/price.json",
+      "$ref": "/schemas/3.1.20/core/price.json",
       "description": "Tuition or course fee."
     },
     "duration": {
@@ -99,12 +99,12 @@
       "type": "array",
       "description": "Typed creative asset pools for this program. Uses the same OfferingAssetGroup structure as offering-type catalogs. Standard group IDs: 'images_landscape' (campus/program hero), 'images_vertical' (9:16 for Stories), 'logo' (institution logo). Enables formats to declare typed image requirements that map unambiguously to the right asset regardless of platform.",
       "items": {
-        "$ref": "/schemas/3.1.15/core/offering-asset-group.json"
+        "$ref": "/schemas/3.1.20/core/offering-asset-group.json"
       },
       "minItems": 1
     },
     "ext": {
-      "$ref": "/schemas/3.1.15/core/ext.json"
+      "$ref": "/schemas/3.1.20/core/ext.json"
     }
   },
   "required": [

package/dist/lib/schemas-data/3.1/core/error.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/core/error.json",
+  "$id": "/schemas/3.1.20/core/error.json",
   "title": "Error",
   "description": "Standard error structure for task-specific errors and warnings",
   "type": "object",

package/dist/lib/schemas-data/3.1/core/evaluator-spec.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/core/evaluator-spec.json",
+  "$id": "/schemas/3.1.20/core/evaluator-spec.json",
   "title": "Evaluator Spec",
   "description": "Advisory buyer-attached pointer (#5280) declaring HOW produced build_creative variants should be evaluated and ranked. The rank-side of the get_creative_features feature oracle: the chosen form is the SOURCE of feature evaluation that yields creative-feature values for each leaf, `feature_requirement` is an optional hard GATE over those values, and `rank_by` is the RANK ordering over the survivors. Informs the agent's best_of_n recommended/rank and, when the agent advertises creative.supports_evaluator, populates a per-leaf `eval` block (creative-feature-result[]) on the response.\n\nGate-then-rank pipeline (per produced leaf in a best_of_n run): the producing agent (1) evaluates the leaf via the chosen form, obtaining creative-feature values; (2) when `feature_requirement` is present, applies those predicates and DROPS any leaf that fails (internal best_of_n pruning) — survivors only; (3) orders survivors by `rank_by`. The gate operates BEFORE return: it prunes which leaves the agent recommends/returns from its own best_of_n exploration, never an AdCP-layer block of an already-produced billable leaf — what is produced and billed is governed by max_variants/max_creatives/max_spend, not by the evaluator. With no `feature_requirement`, evaluation stays advisory: every produced leaf is returned and billed and ranking is a soft preference, so `rank_by` failures rank lower but are never dropped.\n\nWhen the chosen form is `feature_agent` (or `agent_url`), the seller calls an external get_creative_features-capable agent, so the pointer is subject to the seller's `creative_policy.accepted_verifiers[]` allowlist exactly as #5280 established for provenance verify_agent: the buyer REPRESENTS which on-list agent it used, the seller (verifier-of-record) CALLS it. An off-list agent is rejected with `EVALUATOR_AGENT_NOT_ACCEPTED` (mirrors PROVENANCE_VERIFIER_NOT_ACCEPTED) before any outbound call; an on-list agent that is unreachable or unknown degrades to seller-default ranking with an advisory errors[] note (non-terminal), NOT a failure.\n\nEvaluator credentials and caller-supplied trust material are never carried in this object, `context`, `ext`, or the creative payload. The producing creative agent authenticates its outbound call to the evaluator on the transport (RFC 9421 request signing/JWKS, mTLS, or a pre-provisioned Bearer/API-key credential). Credential- or trust-material payload keys (for example `api_key`, `client_secret`, `authorization`, `jwk`, `jwks`, or `jwks_uri`) are non-conforming and should be rejected with `CREDENTIAL_IN_ARGS`.\n\nProvide exactly one of three forms; an optional `feature_requirement` gate, an optional `rank_by` ordering, an optional `feature_agent` allowlisted pointer, and a shared optional eval_budget apply to whichever form is chosen. Feature discovery uses the existing governance.creative_features catalog on get_adcp_capabilities; evaluator outputs reuse creative-feature-result[] and do not mint a parallel verdict/result surface. `evaluator_id` is not discovered from governance.creative_features: it is a pre-provisioned, account-arranged preset whose emitted feature_ids still come from that catalog.\n\nExperimental (x-status: experimental): this whole evaluator surface — the `evaluator` input, the per-leaf `eval` response block, and `creative.supports_evaluator` — is new and not yet field-tested across parties. Sellers that implement it MUST list `creative.evaluator` in `experimental_features`. Reserved 3.x follow-ons that may reshape these fields: a separate `supports_evaluator_gate` capability and a hard MUST-enforce-gate semantic. Per docs/reference/experimental-status, it MAY change between 3.x releases with notice.",
   "x-status": "experimental",
@@ -10,7 +10,7 @@
       "type": "array",
       "description": "Optional hard GATE over creative-feature values — the predicates a leaf MUST satisfy for the producing agent to recommend/return it. Reuses the feature-requirement shape (min_value/max_value for quantitative features like creative_quality_score, allowed_values for binary/categorical) — the same predicate vocabulary that gates property/audience filters, which its own schema names as an intended creative-gate reuse. A leaf that fails any predicate is DROPPED from the agent's best_of_n survivors before ranking — this is internal pruning of which leaves the agent recommends, not an AdCP-layer block of an already-produced billable leaf (what is produced/billed is governed by max_variants/max_creatives/max_spend). Distinct from `rank_by`: the gate is a pass/fail predicate (drop on fail), `rank_by` is an ordering over survivors. Each predicate's `if_not_covered` (exclude|include, default exclude) is the fail-open knob when the source cannot measure that feature. A pass/warn/fail verdict is expressed as a categorical string feature value gated via `allowed_values` (e.g. [\"pass\"] or [\"pass\",\"warn\"]) — the buyer's predicate decides whether warn passes; the verdict is derived, never stored on creative-feature-result. Omit to leave evaluation advisory (no leaf is dropped).",
       "items": {
-        "$ref": "/schemas/3.1.15/core/feature-requirement.json"
+        "$ref": "/schemas/3.1.20/core/feature-requirement.json"
       },
       "minItems": 1
     },
@@ -79,7 +79,7 @@
       "additionalProperties": true
     },
     "ext": {
-      "$ref": "/schemas/3.1.15/core/ext.json"
+      "$ref": "/schemas/3.1.20/core/ext.json"
     }
   },
   "oneOf": [
@@ -97,14 +97,14 @@
             "pass": {
               "type": "array",
               "items": {
-                "$ref": "/schemas/3.1.15/content-standards/artifact.json"
+                "$ref": "/schemas/3.1.20/content-standards/artifact.json"
               },
               "description": "Artifacts exemplifying variants the buyer considers good — the high end (≈1) of the calibrated prediction feature."
             },
             "fail": {
               "type": "array",
               "items": {
-                "$ref": "/schemas/3.1.15/content-standards/artifact.json"
+                "$ref": "/schemas/3.1.20/content-standards/artifact.json"
               },
               "description": "Artifacts exemplifying variants the buyer considers bad — the low end (≈0) of the calibrated prediction feature."
             }

package/dist/lib/schemas-data/3.1/core/event-custom-data.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/core/event-custom-data.json",
+  "$id": "/schemas/3.1.20/core/event-custom-data.json",
   "title": "Event Custom Data",
   "description": "Event-specific data for attribution and reporting",
   "type": "object",
@@ -90,7 +90,7 @@
       }
     },
     "ext": {
-      "$ref": "/schemas/3.1.15/core/ext.json"
+      "$ref": "/schemas/3.1.20/core/ext.json"
     }
   },
   "additionalProperties": true