@adcp/sdk 16.6.0 → 16.6.1

package/dist/lib/schemas-data/3.2/media-buy/get-media-buy-delivery-response.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://adcontextprotocol.org/schemas/3.2.7/media-buy/get-media-buy-delivery-response.json",
+  "$id": "https://adcontextprotocol.org/schemas/3.2.8/media-buy/get-media-buy-delivery-response.json",
   "title": "Get Media Buy Delivery Response",
   "description": "Response payload for get_media_buy_delivery task",
   "x-adcp-validation": {
@@ -14,10 +14,10 @@
   "type": "object",
   "allOf": [
     {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/version-envelope.json"
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/version-envelope.json"
     },
     {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/protocol-envelope.json"
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/protocol-envelope.json"
     },
     {
       "if": {
@@ -146,7 +146,7 @@
         "control_totals": {
           "type": "array",
           "items": {
-            "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/reporting-control-total.json"
+            "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/reporting-control-total.json"
           }
         },
         "content_sha256": {
@@ -164,7 +164,7 @@
       "additionalProperties": false
     },
     "reporting_revision": {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/reporting-revision.json",
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/reporting-revision.json",
       "description": "Full immutable revision metadata, identical to the get_reporting_status revision record."
     },
     "reporting_rows": {
@@ -175,7 +175,7 @@
       "description": "One page of authoritative logical rows for an exact reporting_revision_id read. Validate every row against the revision's digest-pinned schema; concatenate pages in cursor order before verifying the binding digest."
     },
     "pagination": {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/pagination-response.json",
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/pagination-response.json",
       "description": "Exact revision pages are frozen for the cursor walk. total_count is mandatory for reporting_revision_id and equals reporting_revision.row_count and reporting_revision_binding.row_count; it counts the complete ordered row sequence, not this page."
     },
     "currency": {
@@ -186,7 +186,7 @@
       "pattern": "^[A-Z]{3}$"
     },
     "attribution_window": {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/attribution-window.json",
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/attribution-window.json",
       "description": "Attribution methodology and lookback windows used for conversion metrics in this response. All media buys from a single seller share the same attribution methodology. Enables cross-platform comparison (e.g., Amazon 14-day click vs. Criteo 30-day click)."
     },
     "aggregated_totals": {
@@ -289,7 +289,7 @@
         "reach_aggregation": {
           "allOf": [
             {
-              "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/reach-aggregation.json"
+              "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/reach-aggregation.json"
             }
           ],
           "description": "How reach was combined across the media buys in this aggregate. When omitted, legacy reach semantics are unknown and consumers MUST NOT use reach as the denominator for frequency."
@@ -297,7 +297,7 @@
         "reach_unit": {
           "allOf": [
             {
-              "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/reach-unit.json"
+              "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/reach-unit.json"
             }
           ],
           "description": "Unit of measurement for reach. Only present when all aggregated media buys use the same reach_unit."
@@ -316,7 +316,7 @@
           "type": "array",
           "description": "Cross-buy delivery aggregates partitioned by qualifier. Row-symmetric with `package.committed_metrics` and `by_package[].missing_metrics` — same atomic unit `(scope, metric_id, qualifier)` — so reconciliation collapses to a row-level join on the tuple. Granularity rule: one row per `(metric_id, full-qualifier-set)`, reported at the finest available granularity; buyers re-aggregate up if they want a coarser view. Used only for metrics with non-empty qualifier sets — unqualified metrics (`impressions`, `spend`, `media_buy_count`, etc.) remain at the top of `aggregated_totals`. **Mutual exclusion MUST**: for any `metric_id` appearing in `metric_aggregates`, the corresponding top-level scalar in `aggregated_totals` MUST be omitted (not zeroed) — avoids duplicate sources of truth. The qualifier vocabulary on this delivery surface is closed today (`additionalProperties: false`, same content as `committed_metrics.qualifier`) but is expected to **diverge from contract qualifier in future minors** as transparency disclosures buyers don't commit to ship delivery-only (e.g., `tracker_firing` pending #3832 resolution). Each row carries a `value` plus inlined per-metric component fields (e.g., `measurable_impressions` and `viewable_impressions` for `viewable_rate`; `spend` and `conversions` for `cost_per_acquisition`). Per-buy `totals` keeps its flat shape — each buy is single-qualifier by definition; only the aggregate spans qualifiers. **Qualifier-set drift across reports**: when a campaign gains a new qualifier mid-flight (e.g., adds `tracker_firing` partitioning in week 2), prior periods' rows remain valid at their original granularity; buyers SHOULD NOT retroactively repartition.",
           "items": {
-            "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/delivery-metric-aggregate.json"
+            "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/delivery-metric-aggregate.json"
           },
           "examples": [
             [
@@ -412,7 +412,7 @@
             "description": "ISO 8601 timestamp at which this row became final. Present only when `is_final: true`. Anchors the buyer's reconciliation and (when later defined) dispute-window clocks against the buy's `measurement_terms.billing_measurement`. Computed as the latest `finalized_at` across the row's packages for the reconciliation window."
           },
           "pricing_model": {
-            "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/pricing-model.json",
+            "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/pricing-model.json",
             "description": "Pricing model used for this media buy"
           },
           "pacing_index": {
@@ -423,7 +423,7 @@
           "totals": {
             "allOf": [
               {
-                "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/delivery-metrics.json"
+                "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/delivery-metrics.json"
               },
               {
                 "type": "object",
@@ -445,7 +445,7 @@
             "items": {
               "allOf": [
                 {
-                  "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/delivery-metrics.json"
+                  "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/delivery-metrics.json"
                 },
                 {
                   "type": "object",
@@ -461,7 +461,7 @@
                       "minimum": 0
                     },
                     "pricing_model": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/pricing-model.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/pricing-model.json",
                       "description": "The pricing model used for this package (e.g., cpm, cpcv, cpp). Indicates how the package is billed and which metrics are most relevant for optimization."
                     },
                     "rate": {
@@ -475,7 +475,7 @@
                       "pattern": "^[A-Z]{3}$"
                     },
                     "delivery_status": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/delivery-status.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/delivery-status.json",
                       "description": "System-reported operational state of this package. Reflects actual delivery state independent of buyer pause control. 'not_delivering' means zero impressions were recorded for the entire reporting_period while the package was in-flight. Sellers SHOULD only report 'not_delivering' once the package's data is_final for the period — a provisional (is_final: false) zero may still be measurement catching up, not genuine non-delivery."
                     },
                     "paused": {
@@ -514,7 +514,7 @@
                       "type": "array",
                       "description": "Metrics that the binding reporting contract declared but that are NOT populated in this report. Reconciliation source: when `package.committed_metrics` is present, `missing_metrics` is computed against entries where `committed_at < reporting_period.end` — independent of subsequent product mutations and respecting the commitment timestamp on each entry (a metric committed mid-flight is only flagged missing in reports for periods after its commitment). When `package.committed_metrics` is absent, fall back to the product's current `reporting_capabilities.available_metrics` (no timestamp filter). Empty array (or absent) indicates clean delivery against the contract. Non-empty signals an accountability breach — the seller committed to the metric but did not produce the value here. Sellers MUST exclude metrics that are not yet measurable for the current `measurement_window` (e.g., post-IVT counts during the live window) — those will appear (or not) when a wider window supersedes this report via `supersedes_window`. Each entry uses an explicit `scope` discriminator: `standard` for entries from the closed `available-metric.json` enum, `vendor` for vendor-defined metrics anchored on a BrandRef. Symmetric with `committed_metrics`. When the request narrowed the payload via requested_metrics, sellers MUST NOT list a committed metric here solely because the buyer excluded it — missing_metrics reports delivery gaps, not request narrowing.",
                       "items": {
-                        "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/missing-metric.json"
+                        "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/missing-metric.json"
                       },
                       "examples": [
                         [],
@@ -543,14 +543,14 @@
                       "type": "array",
                       "description": "Qualified standard delivery values for this package. Each entry is the delivered counterpart to a standard-scope package.committed_metrics or by_package[].missing_metrics row, using the same atomic key (scope, metric_id, qualifier). Sellers report one row per full qualifier set at package grain; when a metric appears here, its flat scalar counterpart on the package MUST be omitted to avoid two sources of truth. Vendor-scope values continue to use vendor_metric_values. Buyers reconcile rows directly and perform any compatible cross-package aggregation themselves.",
                       "items": {
-                        "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/package-delivery-metric-value.json"
+                        "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/package-delivery-metric-value.json"
                       }
                     },
                     "by_catalog_item": {
                       "type": "array",
                       "description": "Delivery by catalog item within this package. Available for catalog-driven packages when the seller supports item-level reporting.",
                       "items": {
-                        "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/catalog-item-delivery-metrics.json"
+                        "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/catalog-item-delivery-metrics.json"
                       }
                     },
                     "by_catalog_item_truncated": {
@@ -558,18 +558,18 @@
                       "description": "Whether by_catalog_item was truncated due to the requested limit or a seller-imposed maximum. Sellers MUST return this flag whenever by_catalog_item is present and the request included reporting_dimensions.catalog_item (false means the list is complete). When the breakdown was returned automatically without a request key, the flag is RECOMMENDED but not required — automatic rows carry no completeness contract."
                     },
                     "by_catalog_item_sorted_by": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-metric.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-metric.json",
                       "description": "The metric actually used to order by_catalog_item rows. Sellers MUST return this field whenever by_catalog_item is present and the request included reporting_dimensions.catalog_item. When the seller cannot sort by the requested sort_by metric it falls back to 'spend'; this echo makes the fallback visible instead of silently returning rows the buyer will misread as ordered by the requested metric. When the breakdown was returned automatically without a request key, the field is RECOMMENDED but not required — automatic rows carry no completeness contract."
                     },
                     "by_catalog_item_sort_direction": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-direction.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-direction.json",
                       "description": "The direction actually applied to by_catalog_item ordering. Sellers MUST return this field whenever by_catalog_item is present and the request included reporting_dimensions.catalog_item, alongside by_catalog_item_sorted_by. When the breakdown was returned automatically without a request key, the field is RECOMMENDED but not required — automatic rows carry no completeness contract."
                     },
                     "by_creative": {
                       "type": "array",
                       "description": "Metrics broken down by creative within this package. Available when the seller supports creative-level reporting.",
                       "items": {
-                        "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/creative-delivery-metrics.json"
+                        "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/creative-delivery-metrics.json"
                       }
                     },
                     "by_format": {
@@ -578,13 +578,13 @@
                       "items": {
                         "allOf": [
                           {
-                            "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/delivery-metrics.json"
+                            "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/delivery-metrics.json"
                           },
                           {
                             "type": "object",
                             "properties": {
                               "format_kind": {
-                                "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/canonical-format-kind.json",
+                                "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/canonical-format-kind.json",
                                 "description": "Canonical creative format kind aggregated by this row. This identifies creative shape, not duration or other format-option parameters."
                               }
                             },
@@ -602,11 +602,11 @@
                       "description": "Whether by_format was truncated due to the requested limit or a seller-imposed maximum. Sellers MUST return this flag whenever by_format is present (false means the list is complete)."
                     },
                     "by_format_sorted_by": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-metric.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-metric.json",
                       "description": "The metric actually used to order by_format rows. Sellers MUST return this field whenever by_format is present. When the seller cannot sort by the requested sort_by metric it falls back to 'spend'; this echo makes the fallback visible instead of silently returning rows the buyer will misread as ordered by the requested metric."
                     },
                     "by_format_sort_direction": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-direction.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-direction.json",
                       "description": "The direction actually applied to by_format ordering. Sellers MUST return this field whenever by_format is present."
                     },
                     "by_creative_truncated": {
@@ -614,18 +614,18 @@
                       "description": "Whether by_creative was truncated due to the requested limit or a seller-imposed maximum. Sellers MUST return this flag whenever by_creative is present and the request included reporting_dimensions.creative (false means the list is complete). When the breakdown was returned automatically without a request key, the flag is RECOMMENDED but not required — automatic rows carry no completeness contract."
                     },
                     "by_creative_sorted_by": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-metric.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-metric.json",
                       "description": "The metric actually used to order by_creative rows. Sellers MUST return this field whenever by_creative is present and the request included reporting_dimensions.creative. When the seller cannot sort by the requested sort_by metric it falls back to 'spend'; this echo makes the fallback visible instead of silently returning rows the buyer will misread as ordered by the requested metric. When the breakdown was returned automatically without a request key, the field is RECOMMENDED but not required — automatic rows carry no completeness contract."
                     },
                     "by_creative_sort_direction": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-direction.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-direction.json",
                       "description": "The direction actually applied to by_creative ordering. Sellers MUST return this field whenever by_creative is present and the request included reporting_dimensions.creative, alongside by_creative_sorted_by. When the breakdown was returned automatically without a request key, the field is RECOMMENDED but not required — automatic rows carry no completeness contract."
                     },
                     "by_keyword": {
                       "type": "array",
                       "description": "Metrics broken down by keyword within this package. One row per (keyword, match_type) pair — the same keyword with different match types appears as separate rows. Keyword-grain only: rows reflect aggregate performance of each targeted keyword, not individual search queries. Rows may not sum to package totals when a single impression is attributed to the triggering keyword only. Available for search and retail media packages when the seller supports keyword-level reporting.",
                       "items": {
-                        "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/keyword-delivery-metrics.json"
+                        "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/keyword-delivery-metrics.json"
                       }
                     },
                     "by_keyword_truncated": {
@@ -633,18 +633,18 @@
                       "description": "Whether by_keyword was truncated due to the requested limit or a seller-imposed maximum. Sellers MUST return this flag whenever by_keyword is present and the request included reporting_dimensions.keyword (false means the list is complete). When the breakdown was returned automatically without a request key, the flag is RECOMMENDED but not required — automatic rows carry no completeness contract."
                     },
                     "by_keyword_sorted_by": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-metric.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-metric.json",
                       "description": "The metric actually used to order by_keyword rows. Sellers MUST return this field whenever by_keyword is present and the request included reporting_dimensions.keyword. When the seller cannot sort by the requested sort_by metric it falls back to 'spend'; this echo makes the fallback visible instead of silently returning rows the buyer will misread as ordered by the requested metric. When the breakdown was returned automatically without a request key, the field is RECOMMENDED but not required — automatic rows carry no completeness contract."
                     },
                     "by_keyword_sort_direction": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-direction.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-direction.json",
                       "description": "The direction actually applied to by_keyword ordering. Sellers MUST return this field whenever by_keyword is present and the request included reporting_dimensions.keyword, alongside by_keyword_sorted_by. When the breakdown was returned automatically without a request key, the field is RECOMMENDED but not required — automatic rows carry no completeness contract."
                     },
                     "by_geo": {
                       "type": "array",
                       "description": "Delivery by geographic area within this package. Available when the buyer requests geo breakdown via reporting_dimensions and the seller supports it. Each dimension's rows are independent slices that should sum to the package total.",
                       "items": {
-                        "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/geo-delivery-metrics.json"
+                        "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/geo-delivery-metrics.json"
                       }
                     },
                     "by_geo_truncated": {
@@ -652,11 +652,11 @@
                       "description": "Whether by_geo was truncated due to the requested limit or a seller-imposed maximum. Sellers MUST return this flag whenever by_geo is present (false means the list is complete)."
                     },
                     "by_geo_sorted_by": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-metric.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-metric.json",
                       "description": "The metric actually used to order by_geo rows. Sellers MUST return this field whenever by_geo is present. When the seller cannot sort by the requested sort_by metric it falls back to 'spend'; this echo makes the fallback visible instead of silently returning rows the buyer will misread as ordered by the requested metric."
                     },
                     "by_geo_sort_direction": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-direction.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-direction.json",
                       "description": "The direction actually applied to by_geo ordering. Sellers MUST return this field whenever by_geo is present."
                     },
                     "by_device_type": {
@@ -665,13 +665,13 @@
                       "items": {
                         "allOf": [
                           {
-                            "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/delivery-metrics.json"
+                            "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/delivery-metrics.json"
                           },
                           {
                             "type": "object",
                             "properties": {
                               "device_type": {
-                                "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/device-type.json",
+                                "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/device-type.json",
                                 "description": "Device form factor (desktop, mobile, tablet, ctv, dooh, unknown)"
                               }
                             },
@@ -689,15 +689,15 @@
                       "description": "Whether by_device_type was truncated. Sellers MUST return this flag whenever by_device_type is present (false means the list is complete)."
                     },
                     "by_device_type_sorted_by": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-metric.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-metric.json",
                       "description": "The metric actually used to order by_device_type rows. Sellers MUST return this field whenever by_device_type is present. When the seller cannot sort by the requested sort_by metric it falls back to 'spend'; this echo makes the fallback visible instead of silently returning rows the buyer will misread as ordered by the requested metric."
                     },
                     "by_device_type_sort_direction": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-direction.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-direction.json",
                       "description": "The direction actually applied to by_device_type ordering. Sellers MUST return this field whenever by_device_type is present."
                     },
                     "by_device_type_pagination": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/pagination-response.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/pagination-response.json",
                       "description": "Cursor to retrieve the remaining by_device_type rows when by_device_type_truncated is true. Sellers MUST return this field whenever by_device_type_truncated is true; omit when false or when by_device_type is absent. Pass the cursor back in the corresponding request's reporting_dimensions.device_type.cursor to fetch the next page; other reporting_dimensions.device_type request fields (limit, sort_by, sort_direction) MUST be repeated unchanged across paged requests."
                     },
                     "by_device_platform": {
@@ -706,13 +706,13 @@
                       "items": {
                         "allOf": [
                           {
-                            "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/delivery-metrics.json"
+                            "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/delivery-metrics.json"
                           },
                           {
                             "type": "object",
                             "properties": {
                               "device_platform": {
-                                "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/device-platform.json",
+                                "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/device-platform.json",
                                 "description": "Operating system platform"
                               }
                             },
@@ -730,15 +730,15 @@
                       "description": "Whether by_device_platform was truncated. Sellers MUST return this flag whenever by_device_platform is present (false means the list is complete)."
                     },
                     "by_device_platform_sorted_by": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-metric.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-metric.json",
                       "description": "The metric actually used to order by_device_platform rows. Sellers MUST return this field whenever by_device_platform is present. When the seller cannot sort by the requested sort_by metric it falls back to 'spend'; this echo makes the fallback visible instead of silently returning rows the buyer will misread as ordered by the requested metric."
                     },
                     "by_device_platform_sort_direction": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-direction.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-direction.json",
                       "description": "The direction actually applied to by_device_platform ordering. Sellers MUST return this field whenever by_device_platform is present."
                     },
                     "by_device_platform_pagination": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/pagination-response.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/pagination-response.json",
                       "description": "Cursor to retrieve the remaining by_device_platform rows when by_device_platform_truncated is true. Sellers MUST return this field whenever by_device_platform_truncated is true; omit when false or when by_device_platform is absent. Pass the cursor back in the corresponding request's reporting_dimensions.device_platform.cursor to fetch the next page; other reporting_dimensions.device_platform request fields (limit, sort_by, sort_direction) MUST be repeated unchanged across paged requests."
                     },
                     "by_audience": {
@@ -747,7 +747,7 @@
                       "items": {
                         "allOf": [
                           {
-                            "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/delivery-metrics.json"
+                            "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/delivery-metrics.json"
                           },
                           {
                             "type": "object",
@@ -758,7 +758,7 @@
                                 "x-entity": "audience"
                               },
                               "audience_source": {
-                                "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/audience-source.json",
+                                "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/audience-source.json",
                                 "description": "Origin of the audience segment (synced, platform, third_party, lookalike, retargeting, unknown)"
                               },
                               "audience_name": {
@@ -781,15 +781,15 @@
                       "description": "Whether by_audience was truncated. Sellers MUST return this flag whenever by_audience is present (false means the list is complete)."
                     },
                     "by_audience_sorted_by": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-metric.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-metric.json",
                       "description": "The metric actually used to order by_audience rows. Sellers MUST return this field whenever by_audience is present. When the seller cannot sort by the requested sort_by metric it falls back to 'spend'; this echo makes the fallback visible instead of silently returning rows the buyer will misread as ordered by the requested metric."
                     },
                     "by_audience_sort_direction": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-direction.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-direction.json",
                       "description": "The direction actually applied to by_audience ordering. Sellers MUST return this field whenever by_audience is present."
                     },
                     "by_audience_pagination": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/pagination-response.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/pagination-response.json",
                       "description": "Cursor to retrieve the remaining by_audience rows when by_audience_truncated is true. Sellers MUST return this field whenever by_audience_truncated is true; omit when false or when by_audience is absent. Pass the cursor back in the corresponding request's reporting_dimensions.audience.cursor to fetch the next page; other reporting_dimensions.audience request fields (limit, sort_by, sort_direction) MUST be repeated unchanged across paged requests."
                     },
                     "by_demographic": {
@@ -798,7 +798,7 @@
                       "items": {
                         "allOf": [
                           {
-                            "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/delivery-metrics.json"
+                            "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/delivery-metrics.json"
                           },
                           {
                             "type": "object",
@@ -810,11 +810,11 @@
                                 "description": "Demographic code in the declared system's notation (for example, P25-54 for Nielsen)."
                               },
                               "demographic_system": {
-                                "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/demographic-system.json",
+                                "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/demographic-system.json",
                                 "description": "Measurement system that defines the demographic code."
                               },
                               "age": {
-                                "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/demographic-age-range.json",
+                                "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/demographic-age-range.json",
                                 "description": "Canonical age interval represented by this row. Required by protocol semantics for age ranges requested through reporting_dimensions.demographic.age_ranges and for intervals declared in the product's demographic reporting capability."
                               }
                             },
@@ -833,11 +833,11 @@
                       "description": "Whether non-suppressed by_demographic rows were truncated due to the requested limit or a seller-imposed maximum. Sellers MUST return this flag whenever by_demographic is present. False means every non-suppressed row is present; inspect by_demographic_suppressed separately before reconciling rows to package totals."
                     },
                     "by_demographic_sorted_by": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-metric.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-metric.json",
                       "description": "The metric actually used to order by_demographic rows. Sellers MUST return this field whenever by_demographic is present. When the seller cannot sort by the requested sort_by metric it falls back to 'spend'; this echo makes the fallback visible instead of silently returning rows the buyer will misread as ordered by the requested metric."
                     },
                     "by_demographic_sort_direction": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-direction.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-direction.json",
                       "description": "The direction actually applied to by_demographic ordering. Sellers MUST return this field whenever by_demographic is present."
                     },
                     "by_demographic_suppressed": {
@@ -848,7 +848,7 @@
                       "type": "array",
                       "description": "Delivery by placement within this package. placement_id remains required for 3.1 compatibility. New 3.2 sellers also emit placement_identity, whose discriminator separates publisher-catalog identity from sales-agent-defined inline identity.",
                       "items": {
-                        "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/placement-delivery-metrics.json"
+                        "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/placement-delivery-metrics.json"
                       }
                     },
                     "by_placement_truncated": {
@@ -856,22 +856,22 @@
                       "description": "Whether by_placement was truncated. Sellers MUST return this flag whenever by_placement is present (false means the list is complete)."
                     },
                     "by_placement_sorted_by": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-metric.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-metric.json",
                       "description": "The metric actually used to order by_placement rows. Sellers MUST return this field whenever by_placement is present. When the seller cannot sort by the requested sort_by metric it falls back to 'spend'; this echo makes the fallback visible instead of silently returning rows the buyer will misread as ordered by the requested metric."
                     },
                     "by_placement_sort_direction": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-direction.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-direction.json",
                       "description": "The direction actually applied to by_placement ordering. Sellers MUST return this field whenever by_placement is present."
                     },
                     "by_placement_pagination": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/pagination-response.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/pagination-response.json",
                       "description": "Cursor to retrieve the remaining by_placement rows when by_placement_truncated is true. Sellers MUST return this field whenever by_placement_truncated is true; omit when false or when by_placement is absent. Pass the cursor back in the corresponding request's reporting_dimensions.placement.cursor to fetch the next page; other reporting_dimensions.placement request fields (limit, sort_by, sort_direction) MUST be repeated unchanged across paged requests."
                     },
                     "by_property": {
                       "type": "array",
                       "description": "Delivery by publisher property within this package. Each row identifies the actual surface with an operational identifier and adds property_ref when it resolves to a canonical publisher catalog entry. Rows are independent of by_collection.",
                       "items": {
-                        "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/property-delivery-metrics.json"
+                        "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/property-delivery-metrics.json"
                       }
                     },
                     "by_property_truncated": {
@@ -883,18 +883,18 @@
                       "description": "Whether one or more otherwise reportable by_property rows were omitted from this response due to privacy, policy, or measurement thresholds. Sellers MUST return this flag whenever by_property is present. False means no rows were threshold-suppressed. Both suppression and truncation may be true."
                     },
                     "by_property_sorted_by": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-metric.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-metric.json",
                       "description": "The metric actually used to order by_property rows. Sellers MUST return this field whenever by_property is present."
                     },
                     "by_property_sort_direction": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-direction.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-direction.json",
                       "description": "The direction actually applied to by_property rows. Sellers MUST return this field whenever by_property is present."
                     },
                     "by_collection": {
                       "type": "array",
                       "description": "Delivery by publisher-scoped collection within this package. This is a marginal breakdown and does not by itself prove which property carried a collection.",
                       "items": {
-                        "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/collection-delivery-metrics.json"
+                        "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/collection-delivery-metrics.json"
                       }
                     },
                     "by_collection_truncated": {
@@ -902,18 +902,18 @@
                       "description": "Whether by_collection was truncated. Sellers MUST return this flag whenever by_collection is present."
                     },
                     "by_collection_sorted_by": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-metric.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-metric.json",
                       "description": "The metric actually used to order by_collection rows. Sellers MUST return this field whenever by_collection is present."
                     },
                     "by_collection_sort_direction": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-direction.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-direction.json",
                       "description": "The direction actually applied to by_collection rows. Sellers MUST return this field whenever by_collection is present."
                     },
                     "by_installment": {
                       "type": "array",
                       "description": "Delivery by canonically identified installment within this package.",
                       "items": {
-                        "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/installment-delivery-metrics.json"
+                        "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/installment-delivery-metrics.json"
                       }
                     },
                     "by_installment_truncated": {
@@ -921,18 +921,18 @@
                       "description": "Whether by_installment was truncated. Sellers MUST return this flag whenever by_installment is present."
                     },
                     "by_installment_sorted_by": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-metric.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-metric.json",
                       "description": "The metric actually used to order by_installment rows. Sellers MUST return this field whenever by_installment is present."
                     },
                     "by_installment_sort_direction": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-direction.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-direction.json",
                       "description": "The direction actually applied to by_installment rows. Sellers MUST return this field whenever by_installment is present."
                     },
                     "by_collection_property": {
                       "type": "array",
                       "description": "Delivery at the collection × property intersection. A row is affirmative delivery evidence that the referenced collection ran on the referenced property; it is not merely a carriage or catalog assertion.",
                       "items": {
-                        "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/collection-property-delivery-metrics.json"
+                        "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/collection-property-delivery-metrics.json"
                       }
                     },
                     "by_collection_property_truncated": {
@@ -944,18 +944,18 @@
                       "description": "Whether one or more otherwise reportable by_collection_property rows were omitted from this response due to privacy, policy, or measurement thresholds. Sellers MUST return this flag whenever by_collection_property is present. False means no rows were threshold-suppressed. Both suppression and truncation may be true."
                     },
                     "by_collection_property_sorted_by": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-metric.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-metric.json",
                       "description": "The metric actually used to order by_collection_property rows. Sellers MUST return this field whenever by_collection_property is present."
                     },
                     "by_collection_property_sort_direction": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-direction.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-direction.json",
                       "description": "The direction actually applied to by_collection_property rows. Sellers MUST return this field whenever by_collection_property is present."
                     },
                     "by_installment_property": {
                       "type": "array",
                       "description": "Delivery at the installment × property intersection. A row is affirmative delivery evidence that the referenced airing, episode, issue, or programming block ran on the referenced property; it is not inferred from collection carriage or independent marginals.",
                       "items": {
-                        "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/installment-property-delivery-metrics.json"
+                        "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/installment-property-delivery-metrics.json"
                       }
                     },
                     "by_installment_property_truncated": {
@@ -967,18 +967,18 @@
                       "description": "Whether one or more otherwise reportable by_installment_property rows were omitted from this response due to privacy, policy, or measurement thresholds. Sellers MUST return this flag whenever by_installment_property is present. False means no rows were threshold-suppressed. Both suppression and truncation may be true."
                     },
                     "by_installment_property_sorted_by": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-metric.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-metric.json",
                       "description": "The metric actually used to order by_installment_property rows. Sellers MUST return this field whenever by_installment_property is present."
                     },
                     "by_installment_property_sort_direction": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-direction.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-direction.json",
                       "description": "The direction actually applied to by_installment_property rows. Sellers MUST return this field whenever by_installment_property is present."
                     },
                     "by_placement_property": {
                       "type": "array",
                       "description": "Delivery at the placement × property intersection. This proves which actual property carried a placement that may span more than one property.",
                       "items": {
-                        "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/placement-property-delivery-metrics.json"
+                        "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/placement-property-delivery-metrics.json"
                       }
                     },
                     "by_placement_property_truncated": {
@@ -990,11 +990,11 @@
                       "description": "Whether one or more otherwise reportable by_placement_property rows were omitted from this response due to privacy, policy, or measurement thresholds. Sellers MUST return this flag whenever by_placement_property is present. False means no rows were threshold-suppressed. Both suppression and truncation may be true."
                     },
                     "by_placement_property_sorted_by": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-metric.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-metric.json",
                       "description": "The metric actually used to order by_placement_property rows. Sellers MUST return this field whenever by_placement_property is present."
                     },
                     "by_placement_property_sort_direction": {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/enums/sort-direction.json",
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/enums/sort-direction.json",
                       "description": "The direction actually applied to by_placement_property rows. Sellers MUST return this field whenever by_placement_property is present."
                     },
                     "by_spot": {
@@ -1003,7 +1003,7 @@
                       "items": {
                         "allOf": [
                           {
-                            "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/delivery-metrics.json"
+                            "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/delivery-metrics.json"
                           },
                           {
                             "type": "object",
@@ -1140,7 +1140,7 @@
                 "totals": {
                   "allOf": [
                     {
-                      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/delivery-metrics.json"
+                      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/delivery-metrics.json"
                     }
                   ],
                   "description": "Aggregate metrics for this window slice across all packages. Shape-aligned with reporting_webhook fire payloads at the same granularity."
@@ -1151,7 +1151,7 @@
                   "items": {
                     "allOf": [
                       {
-                        "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/delivery-metrics.json"
+                        "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/delivery-metrics.json"
                       },
                       {
                         "type": "object",
@@ -1279,7 +1279,7 @@
       "type": "array",
       "description": "Task-specific errors and warnings (e.g., missing delivery data, reporting platform issues)",
       "items": {
-        "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/error.json"
+        "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/error.json"
       }
     },
     "sandbox": {
@@ -1287,10 +1287,10 @@
       "description": "When true, this response contains simulated data from sandbox mode."
     },
     "context": {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/context.json"
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/context.json"
     },
     "ext": {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.7/core/ext.json"
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.8/core/ext.json"
     }
   },
   "required": [