@adcp/sdk 13.0.0 → 13.0.2

package/dist/lib/schemas-data/3.1/media-buy/create-media-buy-request.json

@@ -1,12 +1,12 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/media-buy/create-media-buy-request.json",
+  "$id": "/schemas/3.1.20/media-buy/create-media-buy-request.json",
   "title": "Create Media Buy Request",
   "description": "Request parameters for creating a media buy. Supports two modes: (1) Manual mode - provide packages array with explicit line item configurations, or (2) Proposal mode - provide proposal_id and total_budget to execute a proposal from get_products. One of packages or proposal_id must be provided.",
   "type": "object",
   "allOf": [
     {
-      "$ref": "/schemas/3.1.15/core/version-envelope.json"
+      "$ref": "/schemas/3.1.20/core/version-envelope.json"
     }
   ],
   "x-mutates-state": true,
@@ -24,7 +24,7 @@
       "x-entity": "governance_plan"
     },
     "account": {
-      "$ref": "/schemas/3.1.15/core/account-ref.json",
+      "$ref": "/schemas/3.1.20/core/account-ref.json",
       "description": "Account to bill for this media buy. Pass a natural key (brand, operator, optional sandbox) or a seller-assigned account_id from list_accounts."
     },
     "proposal_id": {
@@ -55,20 +55,20 @@
       "type": "array",
       "description": "Array of package configurations. Required when not using proposal_id. When executing a proposal, this can be omitted and packages will be derived from the proposal's allocations.",
       "items": {
-        "$ref": "/schemas/3.1.15/media-buy/package-request.json"
+        "$ref": "/schemas/3.1.20/media-buy/package-request.json"
       },
       "minItems": 1
     },
     "brand": {
-      "$ref": "/schemas/3.1.15/core/brand-ref.json",
+      "$ref": "/schemas/3.1.20/core/brand-ref.json",
       "description": "Brand reference for this media buy. Resolved to full brand identity at execution time from brand.json or the registry."
     },
     "advertiser_industry": {
-      "$ref": "/schemas/3.1.15/enums/advertiser-industry.json",
+      "$ref": "/schemas/3.1.20/enums/advertiser-industry.json",
       "description": "Industry classification for this specific campaign. A brand may operate across multiple industries (brand.json industries field), but each media buy targets one. For example, a consumer health company running a wellness campaign sends 'healthcare.wellness', not 'cpg'. Sellers map this to platform-native codes (e.g., Spotify ADV categories, LinkedIn industry IDs). When omitted, sellers may infer from the brand manifest's industries field."
     },
     "invoice_recipient": {
-      "$ref": "/schemas/3.1.15/core/business-entity.json",
+      "$ref": "/schemas/3.1.20/core/business-entity.json",
       "description": "Override the account's default billing entity for this specific buy. When provided, the seller invoices this entity instead. The seller MUST validate the invoice recipient is authorized for this account. When governance_agents are configured, the seller MUST include invoice_recipient in the check_governance request."
     },
     "io_acceptance": {
@@ -112,7 +112,7 @@
       "description": "Agency estimate or authorization number. Primary financial reference for broadcast buys — links the order to the agency's media plan and billing system. Travels with the order and creative traffic identifiers through the transaction lifecycle."
     },
     "start_time": {
-      "$ref": "/schemas/3.1.15/core/start-timing.json"
+      "$ref": "/schemas/3.1.20/core/start-timing.json"
     },
     "end_time": {
       "type": "string",
@@ -125,11 +125,11 @@
       "default": false
     },
     "push_notification_config": {
-      "$ref": "/schemas/3.1.15/core/push-notification-config.json",
+      "$ref": "/schemas/3.1.20/core/push-notification-config.json",
       "description": "Optional webhook configuration for async task status notifications. Publisher will send webhooks when status changes (working, input-required, completed, failed, canceled). Buyers SHOULD supply `push_notification_config.operation_id` as the canonical correlation value; publishers echo that field back verbatim in webhook payloads and MUST NOT parse the URL to derive it."
     },
     "reporting_webhook": {
-      "$ref": "/schemas/3.1.15/core/reporting-webhook.json",
+      "$ref": "/schemas/3.1.20/core/reporting-webhook.json",
       "description": "Optional webhook configuration for automated reporting delivery"
     },
     "artifact_webhook": {
@@ -155,7 +155,7 @@
               "type": "array",
               "description": "Array of authentication schemes. ['Bearer'] for simple token auth, ['HMAC-SHA256'] for legacy shared-secret signing. Both are deprecated; new integrations SHOULD use the RFC 9421 webhook signing profile instead.",
               "items": {
-                "$ref": "/schemas/3.1.15/enums/auth-scheme.json"
+                "$ref": "/schemas/3.1.20/enums/auth-scheme.json"
               },
               "minItems": 1,
               "maxItems": 1
@@ -203,10 +203,10 @@
       "additionalProperties": true
     },
     "context": {
-      "$ref": "/schemas/3.1.15/core/context.json"
+      "$ref": "/schemas/3.1.20/core/context.json"
     },
     "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/media-buy/create-media-buy-response.json

@@ -1,15 +1,15 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/media-buy/create-media-buy-response.json",
+  "$id": "/schemas/3.1.20/media-buy/create-media-buy-response.json",
   "title": "Create Media Buy Response",
   "description": "Response payload for create_media_buy. Exactly one of three shapes: (1) synchronous success — media_buy_id and packages are issued in-line, media_buy_status MAY carry the lifecycle value (pending_creatives / pending_start / active / paused), deprecated top-level status MAY carry the same MediaBuyStatus during the 3.1 migration window, and confirmed_at is either the seller commitment timestamp or null for a provisional buy that already exists; provisional buys with confirmed_at: null cannot be active and cannot carry packages[].committed_metrics; (2) terminal failure — an errors array with no media-buy artifact and status != 'submitted'; (3) submitted task envelope — status 'submitted' with task_id when no media_buy_id is being returned to the buyer and the media buy is queued or awaiting a human decision (e.g., IO signing). In the submitted branch, media_buy_id / packages land on the task's completion artifact, not this response. The submitted branch MAY carry advisory errors for non-blocking warnings; terminal failures belong in the error branch. These three shapes are mutually exclusive — a response has exactly one.",
   "type": "object",
   "allOf": [
     {
-      "$ref": "/schemas/3.1.15/core/version-envelope.json"
+      "$ref": "/schemas/3.1.20/core/version-envelope.json"
     },
     {
-      "$ref": "/schemas/3.1.15/core/protocol-envelope.json"
+      "$ref": "/schemas/3.1.20/core/protocol-envelope.json"
     }
   ],
   "oneOf": [
@@ -24,19 +24,19 @@
           "x-entity": "media_buy"
         },
         "account": {
-          "$ref": "/schemas/3.1.15/core/account.json",
+          "$ref": "/schemas/3.1.20/core/account.json",
           "description": "Account billed for this media buy. Includes advertiser, billing proxy (if any), and rate card applied."
         },
         "invoice_recipient": {
-          "$ref": "/schemas/3.1.15/core/business-entity.json",
+          "$ref": "/schemas/3.1.20/core/business-entity.json",
           "description": "Per-buy invoice recipient, echoed from the request when provided. Confirms the seller accepted the billing override. Bank details are omitted (write-only)."
         },
         "media_buy_status": {
-          "$ref": "/schemas/3.1.15/enums/media-buy-status.json",
+          "$ref": "/schemas/3.1.20/enums/media-buy-status.json",
           "description": "Initial media buy status. Either 'pending_creatives' (awaiting creative assets), 'pending_start' (ready to serve, waiting for flight date), 'active' (immediate activation), or 'paused' (created with delivery held after all activation prerequisites are satisfied). Added in 3.1: at the top level of flat-on-the-wire MCP responses, the `status` key is reserved for the envelope TaskStatus (`completed` on synchronous success). Sellers SHOULD emit `media_buy_status` from 3.1 onward; the legacy top-level `status: MediaBuyStatus` form is deprecated and removed in 3.2 (#4906). When the deprecated `status` is also present during the 3.1 deprecation window, both MUST carry identical values — divergent emission is a conformance violation flagged by 3.1 compliance storyboards."
         },
         "status": {
-          "$ref": "/schemas/3.1.15/enums/media-buy-status.json",
+          "$ref": "/schemas/3.1.20/enums/media-buy-status.json",
           "deprecated": true,
           "description": "DEPRECATED in 3.1, removed in 3.2 (#4906). Use `media_buy_status` instead. Top-level `status` here collides with the envelope TaskStatus on flat-serialized MCP wire (see adcontextprotocol/adcp#4895). Buyers consuming 3.1+ responses MUST prefer `media_buy_status` when present; sellers MAY emit both during the deprecation window but MUST emit identical values when doing so — divergent emission is a conformance violation."
         },
@@ -72,14 +72,14 @@
           "type": "array",
           "description": "Flat-vocabulary actions the buyer can perform on this media buy after creation. Saves a round-trip to get_media_buys. Deprecated in favor of `available_actions[]`, which carries `mode`, optional SLA, and optional `terms_ref`. Sellers SHOULD populate both during the 3.x deprecation window; consumers MUST prefer `available_actions[]` when both are present. Removed in 4.0.",
           "items": {
-            "$ref": "/schemas/3.1.15/enums/media-buy-valid-action.json"
+            "$ref": "/schemas/3.1.20/enums/media-buy-valid-action.json"
           }
         },
         "available_actions": {
           "type": "array",
           "description": "Structured per-buy resolution of actions available immediately after creation. Authoritative — see `get-media-buys-response.json` for full semantics.",
           "items": {
-            "$ref": "/schemas/3.1.15/core/media-buy-available-action.json"
+            "$ref": "/schemas/3.1.20/core/media-buy-available-action.json"
           },
           "uniqueItems": true
         },
@@ -87,11 +87,11 @@
           "type": "array",
           "description": "Array of created packages with complete state information",
           "items": {
-            "$ref": "/schemas/3.1.15/core/package.json"
+            "$ref": "/schemas/3.1.20/core/package.json"
           }
         },
         "planned_delivery": {
-          "$ref": "/schemas/3.1.15/core/planned-delivery.json",
+          "$ref": "/schemas/3.1.20/core/planned-delivery.json",
           "description": "The seller's interpreted delivery parameters. Describes what the seller will actually run -- geo, channels, flight dates, frequency caps, and budget. Present when the account has governance_agents or when the seller chooses to provide delivery transparency."
         },
         "sandbox": {
@@ -99,11 +99,11 @@
           "description": "When true, this response contains simulated data from sandbox mode."
         },
         "context": {
-          "$ref": "/schemas/3.1.15/core/context.json",
+          "$ref": "/schemas/3.1.20/core/context.json",
           "description": "Opaque media-buy-level correlation data echoed unchanged from the create_media_buy request. Sellers MUST echo this object verbatim when the originating request carried context, including synchronous success, error, submitted, and webhook task-status payloads. Sellers MUST NOT parse this object for business logic."
         },
         "ext": {
-          "$ref": "/schemas/3.1.15/core/ext.json"
+          "$ref": "/schemas/3.1.20/core/ext.json"
         }
       },
       "allOf": [
@@ -179,16 +179,16 @@
           "type": "array",
           "description": "Array of errors explaining why the operation failed",
           "items": {
-            "$ref": "/schemas/3.1.15/core/error.json"
+            "$ref": "/schemas/3.1.20/core/error.json"
           },
           "minItems": 1
         },
         "context": {
-          "$ref": "/schemas/3.1.15/core/context.json",
+          "$ref": "/schemas/3.1.20/core/context.json",
           "description": "Opaque media-buy-level correlation data echoed unchanged from the create_media_buy request. Sellers MUST echo this object verbatim when the originating request carried context, including synchronous success, error, submitted, and webhook task-status payloads. Sellers MUST NOT parse this object for business logic."
         },
         "ext": {
-          "$ref": "/schemas/3.1.15/core/ext.json"
+          "$ref": "/schemas/3.1.20/core/ext.json"
         }
       },
       "required": [
@@ -249,15 +249,15 @@
           "type": "array",
           "description": "Optional advisory errors accompanying the submitted envelope. Use only for non-blocking warnings (e.g., throttled_severity advisories, governance observations). Terminal failures belong in the error branch, not here.",
           "items": {
-            "$ref": "/schemas/3.1.15/core/error.json"
+            "$ref": "/schemas/3.1.20/core/error.json"
           }
         },
         "context": {
-          "$ref": "/schemas/3.1.15/core/context.json",
+          "$ref": "/schemas/3.1.20/core/context.json",
           "description": "Opaque media-buy-level correlation data echoed unchanged from the create_media_buy request. Sellers MUST echo this object verbatim when the originating request carried context, including synchronous success, error, submitted, and webhook task-status payloads. Sellers MUST NOT parse this object for business logic."
         },
         "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/media-buy/get-media-buy-delivery-request.json

@@ -1,17 +1,17 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/media-buy/get-media-buy-delivery-request.json",
+  "$id": "/schemas/3.1.20/media-buy/get-media-buy-delivery-request.json",
   "title": "Get Media Buy Delivery Request",
   "description": "Request parameters for retrieving comprehensive delivery metrics",
   "type": "object",
   "allOf": [
     {
-      "$ref": "/schemas/3.1.15/core/version-envelope.json"
+      "$ref": "/schemas/3.1.20/core/version-envelope.json"
     }
   ],
   "properties": {
     "account": {
-      "$ref": "/schemas/3.1.15/core/account-ref.json",
+      "$ref": "/schemas/3.1.20/core/account-ref.json",
       "description": "Filter delivery data to a specific account. When omitted, returns data across all accessible accounts."
     },
     "media_buy_ids": {
@@ -26,12 +26,12 @@
     "status_filter": {
       "oneOf": [
         {
-          "$ref": "/schemas/3.1.15/enums/media-buy-status.json"
+          "$ref": "/schemas/3.1.20/enums/media-buy-status.json"
         },
         {
           "type": "array",
           "items": {
-            "$ref": "/schemas/3.1.15/enums/media-buy-status.json"
+            "$ref": "/schemas/3.1.20/enums/media-buy-status.json"
           },
           "minItems": 1
         }
@@ -54,7 +54,7 @@
       "description": "When true, include daily_breakdown arrays within each package in by_package. Useful for per-package pacing analysis and line-item monitoring. Omit or set false to reduce response size — package daily data can be large for multi-package buys over long flights."
     },
     "time_granularity": {
-      "$ref": "/schemas/3.1.15/enums/reporting-frequency.json",
+      "$ref": "/schemas/3.1.20/enums/reporting-frequency.json",
       "description": "Per-window slice granularity for the pull, using the same vocabulary as reporting_webhook.reporting_frequency. When set, the seller returns per-window delivery slices over the date range — useful for reconstructing data a buyer's webhook receiver missed, since the slice payload is shape-aligned with what reporting_webhook would have delivered for the same window. Capability-scoped: the value MUST be one of the seller's declared reporting_capabilities.windowed_pull_granularities; otherwise the seller MUST return UNSUPPORTED_GRANULARITY. When omitted, behavior is unchanged (cumulative aggregates plus optional daily breakdowns per existing fields)."
     },
     "include_window_breakdown": {
@@ -69,7 +69,7 @@
         "post_click": {
           "allOf": [
             {
-              "$ref": "/schemas/3.1.15/core/duration.json"
+              "$ref": "/schemas/3.1.20/core/duration.json"
             }
           ],
           "description": "Post-click attribution window to apply."
@@ -77,13 +77,13 @@
         "post_view": {
           "allOf": [
             {
-              "$ref": "/schemas/3.1.15/core/duration.json"
+              "$ref": "/schemas/3.1.20/core/duration.json"
             }
           ],
           "description": "Post-view attribution window to apply."
         },
         "model": {
-          "$ref": "/schemas/3.1.15/enums/attribution-model.json",
+          "$ref": "/schemas/3.1.20/enums/attribution-model.json",
           "description": "Attribution model to use. When omitted, the seller applies their default model."
         }
       },
@@ -98,19 +98,19 @@
           "description": "Request geographic breakdown. Check reporting_capabilities.supports_geo_breakdown for available levels and systems.",
           "properties": {
             "geo_level": {
-              "$ref": "/schemas/3.1.15/enums/geo-level.json",
+              "$ref": "/schemas/3.1.20/enums/geo-level.json",
               "description": "Geographic granularity level for the breakdown"
             },
             "system": {
               "anyOf": [
                 {
-                  "$ref": "/schemas/3.1.15/enums/metro-system.json"
+                  "$ref": "/schemas/3.1.20/enums/metro-system.json"
                 },
                 {
-                  "$ref": "/schemas/3.1.15/enums/postal-system.json"
+                  "$ref": "/schemas/3.1.20/enums/postal-system.json"
                 },
                 {
-                  "$ref": "/schemas/3.1.15/enums/legacy-postal-system.json"
+                  "$ref": "/schemas/3.1.20/enums/legacy-postal-system.json"
                 }
               ],
               "description": "Optional classification system for metro or postal_area levels. Metro uses metro-system values (e.g., 'nielsen_dma'); native postal_area uses country-local postal-system values with country (e.g., country 'US', system 'zip'); deprecated legacy postal_area requests may use legacy-postal-system values such as 'us_zip'. Omit to request the level without selecting a specific system."
@@ -127,7 +127,7 @@
               "description": "Maximum number of geo entries to return. Defaults to 25. When truncated, by_geo_truncated is true in the response."
             },
             "sort_by": {
-              "$ref": "/schemas/3.1.15/enums/sort-metric.json",
+              "$ref": "/schemas/3.1.20/enums/sort-metric.json",
               "description": "Metric to sort breakdown rows by (descending). Falls back to 'spend' if the seller does not report the requested metric.",
               "default": "spend"
             }
@@ -190,7 +190,7 @@
                   {
                     "properties": {
                       "system": {
-                        "$ref": "/schemas/3.1.15/enums/metro-system.json"
+                        "$ref": "/schemas/3.1.20/enums/metro-system.json"
                       }
                     },
                     "required": [
@@ -235,12 +235,12 @@
                     }
                   },
                   {
-                    "$ref": "/schemas/3.1.15/core/postal-country-system.json"
+                    "$ref": "/schemas/3.1.20/core/postal-country-system.json"
                   },
                   {
                     "properties": {
                       "system": {
-                        "$ref": "/schemas/3.1.15/enums/legacy-postal-system.json"
+                        "$ref": "/schemas/3.1.20/enums/legacy-postal-system.json"
                       }
                     },
                     "required": [
@@ -268,7 +268,7 @@
               "description": "Maximum number of entries to return. When omitted, all entries are returned (the enum is small and bounded)."
             },
             "sort_by": {
-              "$ref": "/schemas/3.1.15/enums/sort-metric.json",
+              "$ref": "/schemas/3.1.20/enums/sort-metric.json",
               "description": "Metric to sort breakdown rows by (descending). Falls back to 'spend' if the seller does not report the requested metric.",
               "default": "spend"
             }
@@ -285,7 +285,7 @@
               "description": "Maximum number of entries to return. When omitted, all entries are returned (the enum is small and bounded)."
             },
             "sort_by": {
-              "$ref": "/schemas/3.1.15/enums/sort-metric.json",
+              "$ref": "/schemas/3.1.20/enums/sort-metric.json",
               "description": "Metric to sort breakdown rows by (descending). Falls back to 'spend' if the seller does not report the requested metric.",
               "default": "spend"
             }
@@ -303,7 +303,7 @@
               "description": "Maximum number of entries to return. Defaults to 25."
             },
             "sort_by": {
-              "$ref": "/schemas/3.1.15/enums/sort-metric.json",
+              "$ref": "/schemas/3.1.20/enums/sort-metric.json",
               "description": "Metric to sort breakdown rows by (descending). Falls back to 'spend' if the seller does not report the requested metric.",
               "default": "spend"
             }
@@ -321,7 +321,7 @@
               "description": "Maximum number of entries to return. Defaults to 25."
             },
             "sort_by": {
-              "$ref": "/schemas/3.1.15/enums/sort-metric.json",
+              "$ref": "/schemas/3.1.20/enums/sort-metric.json",
               "description": "Metric to sort breakdown rows by (descending). Falls back to 'spend' if the seller does not report the requested metric.",
               "default": "spend"
             }
@@ -332,10 +332,10 @@
       "additionalProperties": true
     },
     "context": {
-      "$ref": "/schemas/3.1.15/core/context.json"
+      "$ref": "/schemas/3.1.20/core/context.json"
     },
     "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/media-buy/get-media-buy-delivery-response.json

@@ -1,15 +1,15 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/media-buy/get-media-buy-delivery-response.json",
+  "$id": "/schemas/3.1.20/media-buy/get-media-buy-delivery-response.json",
   "title": "Get Media Buy Delivery Response",
   "description": "Response payload for get_media_buy_delivery task",
   "type": "object",
   "allOf": [
     {
-      "$ref": "/schemas/3.1.15/core/version-envelope.json"
+      "$ref": "/schemas/3.1.20/core/version-envelope.json"
     },
     {
-      "$ref": "/schemas/3.1.15/core/protocol-envelope.json"
+      "$ref": "/schemas/3.1.20/core/protocol-envelope.json"
     }
   ],
   "properties": {
@@ -70,7 +70,7 @@
       "pattern": "^[A-Z]{3}$"
     },
     "attribution_window": {
-      "$ref": "/schemas/3.1.15/core/attribution-window.json",
+      "$ref": "/schemas/3.1.20/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": {
@@ -145,7 +145,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 reach. Only present when all aggregated media buys use the same reach_unit."
@@ -164,7 +164,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": "/schemas/3.1.15/core/delivery-metric-aggregate.json"
+            "$ref": "/schemas/3.1.20/core/delivery-metric-aggregate.json"
           },
           "examples": [
             [
@@ -255,13 +255,13 @@
             "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": "/schemas/3.1.15/enums/pricing-model.json",
+            "$ref": "/schemas/3.1.20/enums/pricing-model.json",
             "description": "Pricing model used for this media buy"
           },
           "totals": {
             "allOf": [
               {
-                "$ref": "/schemas/3.1.15/core/delivery-metrics.json"
+                "$ref": "/schemas/3.1.20/core/delivery-metrics.json"
               },
               {
                 "type": "object",
@@ -285,7 +285,7 @@
             "items": {
               "allOf": [
                 {
-                  "$ref": "/schemas/3.1.15/core/delivery-metrics.json"
+                  "$ref": "/schemas/3.1.20/core/delivery-metrics.json"
                 },
                 {
                   "type": "object",
@@ -301,7 +301,7 @@
                       "minimum": 0
                     },
                     "pricing_model": {
-                      "$ref": "/schemas/3.1.15/enums/pricing-model.json",
+                      "$ref": "/schemas/3.1.20/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": {
@@ -361,7 +361,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`.",
                       "items": {
-                        "$ref": "/schemas/3.1.15/core/missing-metric.json"
+                        "$ref": "/schemas/3.1.20/core/missing-metric.json"
                       },
                       "examples": [
                         [],
@@ -390,28 +390,28 @@
                       "type": "array",
                       "description": "Delivery by catalog item within this package. Available for catalog-driven packages when the seller supports item-level reporting.",
                       "items": {
-                        "$ref": "/schemas/3.1.15/core/catalog-item-delivery-metrics.json"
+                        "$ref": "/schemas/3.1.20/core/catalog-item-delivery-metrics.json"
                       }
                     },
                     "by_creative": {
                       "type": "array",
                       "description": "Metrics broken down by creative within this package. Available when the seller supports creative-level reporting.",
                       "items": {
-                        "$ref": "/schemas/3.1.15/core/creative-delivery-metrics.json"
+                        "$ref": "/schemas/3.1.20/core/creative-delivery-metrics.json"
                       }
                     },
                     "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": "/schemas/3.1.15/core/keyword-delivery-metrics.json"
+                        "$ref": "/schemas/3.1.20/core/keyword-delivery-metrics.json"
                       }
                     },
                     "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": "/schemas/3.1.15/core/geo-delivery-metrics.json"
+                        "$ref": "/schemas/3.1.20/core/geo-delivery-metrics.json"
                       }
                     },
                     "by_geo_truncated": {
@@ -424,13 +424,13 @@
                       "items": {
                         "allOf": [
                           {
-                            "$ref": "/schemas/3.1.15/core/delivery-metrics.json"
+                            "$ref": "/schemas/3.1.20/core/delivery-metrics.json"
                           },
                           {
                             "type": "object",
                             "properties": {
                               "device_type": {
-                                "$ref": "/schemas/3.1.15/enums/device-type.json",
+                                "$ref": "/schemas/3.1.20/enums/device-type.json",
                                 "description": "Device form factor (desktop, mobile, tablet, ctv, dooh, unknown)"
                               }
                             },
@@ -453,13 +453,13 @@
                       "items": {
                         "allOf": [
                           {
-                            "$ref": "/schemas/3.1.15/core/delivery-metrics.json"
+                            "$ref": "/schemas/3.1.20/core/delivery-metrics.json"
                           },
                           {
                             "type": "object",
                             "properties": {
                               "device_platform": {
-                                "$ref": "/schemas/3.1.15/enums/device-platform.json",
+                                "$ref": "/schemas/3.1.20/enums/device-platform.json",
                                 "description": "Operating system platform"
                               }
                             },
@@ -482,7 +482,7 @@
                       "items": {
                         "allOf": [
                           {
-                            "$ref": "/schemas/3.1.15/core/delivery-metrics.json"
+                            "$ref": "/schemas/3.1.20/core/delivery-metrics.json"
                           },
                           {
                             "type": "object",
@@ -493,7 +493,7 @@
                                 "x-entity": "audience"
                               },
                               "audience_source": {
-                                "$ref": "/schemas/3.1.15/enums/audience-source.json",
+                                "$ref": "/schemas/3.1.20/enums/audience-source.json",
                                 "description": "Origin of the audience segment (synced, platform, third_party, lookalike, retargeting, unknown)"
                               },
                               "audience_name": {
@@ -521,7 +521,7 @@
                       "items": {
                         "allOf": [
                           {
-                            "$ref": "/schemas/3.1.15/core/delivery-metrics.json"
+                            "$ref": "/schemas/3.1.20/core/delivery-metrics.json"
                           },
                           {
                             "type": "object",
@@ -636,7 +636,7 @@
                 "totals": {
                   "allOf": [
                     {
-                      "$ref": "/schemas/3.1.15/core/delivery-metrics.json"
+                      "$ref": "/schemas/3.1.20/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."
@@ -647,7 +647,7 @@
                   "items": {
                     "allOf": [
                       {
-                        "$ref": "/schemas/3.1.15/core/delivery-metrics.json"
+                        "$ref": "/schemas/3.1.20/core/delivery-metrics.json"
                       },
                       {
                         "type": "object",
@@ -747,7 +747,7 @@
       "type": "array",
       "description": "Task-specific errors and warnings (e.g., missing delivery data, reporting platform issues)",
       "items": {
-        "$ref": "/schemas/3.1.15/core/error.json"
+        "$ref": "/schemas/3.1.20/core/error.json"
       }
     },
     "sandbox": {
@@ -755,10 +755,10 @@
       "description": "When true, this response contains simulated data from sandbox mode."
     },
     "context": {
-      "$ref": "/schemas/3.1.15/core/context.json"
+      "$ref": "/schemas/3.1.20/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.1.15/core/ext.json"
+      "$ref": "/schemas/3.1.20/core/ext.json"
     }
   },
   "required": [