@adcp/sdk 14.0.0-rc.49 → 14.0.0-rc.50

package/dist/lib/schemas-data/3.1/media-buy/list-creative-formats-request.json

@@ -1,12 +1,12 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.18/media-buy/list-creative-formats-request.json",
+  "$id": "/schemas/3.1.24/media-buy/list-creative-formats-request.json",
   "title": "List Creative Formats Request",
   "description": "Request parameters for discovering supported creative formats",
   "type": "object",
   "allOf": [
     {
-      "$ref": "/schemas/3.1.18/core/version-envelope.json"
+      "$ref": "/schemas/3.1.24/core/version-envelope.json"
     }
   ],
   "properties": {
@@ -14,7 +14,7 @@
       "type": "array",
       "description": "Return only these specific format IDs (e.g., from get_products response)",
       "items": {
-        "$ref": "/schemas/3.1.18/core/format-id.json"
+        "$ref": "/schemas/3.1.24/core/format-id.json"
       },
       "minItems": 1
     },
@@ -22,7 +22,7 @@
       "type": "array",
       "description": "Filter to formats that include these asset types. For third-party tags, search for 'html' or 'javascript'. For published-post reference formats, search for 'published_post'. E.g., ['image', 'text'] returns formats with images and text, ['javascript'] returns formats accepting JavaScript tags.",
       "items": {
-        "$ref": "/schemas/3.1.18/enums/asset-content-type.json"
+        "$ref": "/schemas/3.1.24/enums/asset-content-type.json"
       },
       "minItems": 1
     },
@@ -56,18 +56,18 @@
       "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"
     },
     "property_id": {
-      "$ref": "/schemas/3.1.18/core/property-id.json",
+      "$ref": "/schemas/3.1.24/core/property-id.json",
       "description": "Filter to formats supported on the named property within the publisher's catalog. Resolves to a property in the publisher's `adagents.json` `properties[]`; the agent returns only `formats[]` entries whose `applies_to_property_ids` includes this property (or entries with no scope, which apply to all properties). Typically used in combination with `publisher_domain`."
     },
     "wcag_level": {
-      "$ref": "/schemas/3.1.18/enums/wcag-level.json",
+      "$ref": "/schemas/3.1.24/enums/wcag-level.json",
       "description": "Filter to formats that meet at least this WCAG conformance level (A < AA < AAA)"
     },
     "disclosure_positions": {
       "type": "array",
       "description": "Filter to formats that support all of these disclosure positions. When a format has disclosure_capabilities, match against those positions. Otherwise fall back to supported_disclosure_positions. Use to find formats compatible with a brief's compliance requirements.",
       "items": {
-        "$ref": "/schemas/3.1.18/enums/disclosure-position.json"
+        "$ref": "/schemas/3.1.24/enums/disclosure-position.json"
       },
       "minItems": 1,
       "uniqueItems": true
@@ -76,7 +76,7 @@
       "type": "array",
       "description": "Filter to formats where each requested persistence mode is supported by at least one position in disclosure_capabilities. Different positions may satisfy different modes. Use to find formats compatible with jurisdiction-specific persistence requirements (e.g., continuous for EU AI Act).",
       "items": {
-        "$ref": "/schemas/3.1.18/enums/disclosure-persistence.json"
+        "$ref": "/schemas/3.1.24/enums/disclosure-persistence.json"
       },
       "minItems": 1,
       "uniqueItems": true
@@ -85,7 +85,7 @@
       "type": "array",
       "description": "Filter to formats whose output_format_ids includes any of these format IDs. Returns formats that can produce these outputs — inspect each result's input_format_ids to see what inputs they accept.",
       "items": {
-        "$ref": "/schemas/3.1.18/core/format-id.json"
+        "$ref": "/schemas/3.1.24/core/format-id.json"
       },
       "minItems": 1
     },
@@ -93,18 +93,18 @@
       "type": "array",
       "description": "Filter to formats whose input_format_ids includes any of these format IDs. Returns formats that accept these creatives as input — inspect each result's output_format_ids to see what they can produce.",
       "items": {
-        "$ref": "/schemas/3.1.18/core/format-id.json"
+        "$ref": "/schemas/3.1.24/core/format-id.json"
       },
       "minItems": 1
     },
     "pagination": {
-      "$ref": "/schemas/3.1.18/core/pagination-request.json"
+      "$ref": "/schemas/3.1.24/core/pagination-request.json"
     },
     "context": {
-      "$ref": "/schemas/3.1.18/core/context.json"
+      "$ref": "/schemas/3.1.24/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.1.18/core/ext.json"
+      "$ref": "/schemas/3.1.24/core/ext.json"
     }
   },
   "additionalProperties": true

package/dist/lib/schemas-data/3.1/media-buy/list-creative-formats-response.json

@@ -1,15 +1,15 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.18/media-buy/list-creative-formats-response.json",
+  "$id": "/schemas/3.1.24/media-buy/list-creative-formats-response.json",
   "title": "List Creative Formats Response",
   "description": "Response payload for list_creative_formats task",
   "type": "object",
   "allOf": [
     {
-      "$ref": "/schemas/3.1.18/core/version-envelope.json"
+      "$ref": "/schemas/3.1.24/core/version-envelope.json"
     },
     {
-      "$ref": "/schemas/3.1.18/core/protocol-envelope.json"
+      "$ref": "/schemas/3.1.24/core/protocol-envelope.json"
     }
   ],
   "properties": {
@@ -17,7 +17,7 @@
       "type": "array",
       "description": "Full format definitions for all formats this agent supports. Each format's authoritative source is indicated by its agent_url field.",
       "items": {
-        "$ref": "/schemas/3.1.18/core/format.json"
+        "$ref": "/schemas/3.1.24/core/format.json"
       }
     },
     "source": {
@@ -48,7 +48,7 @@
             "type": "array",
             "description": "Capabilities this creative agent provides",
             "items": {
-              "$ref": "/schemas/3.1.18/enums/creative-agent-capability.json"
+              "$ref": "/schemas/3.1.24/enums/creative-agent-capability.json"
             }
           }
         },
@@ -61,21 +61,21 @@
       "type": "array",
       "description": "Task-specific errors and warnings (e.g., format availability issues)",
       "items": {
-        "$ref": "/schemas/3.1.18/core/error.json"
+        "$ref": "/schemas/3.1.24/core/error.json"
       }
     },
     "pagination": {
-      "$ref": "/schemas/3.1.18/core/pagination-response.json"
+      "$ref": "/schemas/3.1.24/core/pagination-response.json"
     },
     "sandbox": {
       "type": "boolean",
       "description": "When true, this response contains simulated data from sandbox mode."
     },
     "context": {
-      "$ref": "/schemas/3.1.18/core/context.json"
+      "$ref": "/schemas/3.1.24/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.1.18/core/ext.json"
+      "$ref": "/schemas/3.1.24/core/ext.json"
     }
   },
   "required": [

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

@@ -1,12 +1,12 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.18/media-buy/log-event-request.json",
+  "$id": "/schemas/3.1.24/media-buy/log-event-request.json",
   "title": "Log Event Request",
   "description": "Request parameters for logging marketing events",
   "type": "object",
   "allOf": [
     {
-      "$ref": "/schemas/3.1.18/core/version-envelope.json"
+      "$ref": "/schemas/3.1.24/core/version-envelope.json"
     }
   ],
   "x-mutates-state": true,
@@ -24,7 +24,7 @@
       "type": "array",
       "description": "Events to log",
       "items": {
-        "$ref": "/schemas/3.1.18/core/event.json"
+        "$ref": "/schemas/3.1.24/core/event.json"
       },
       "minItems": 1,
       "maxItems": 10000
@@ -37,10 +37,10 @@
       "pattern": "^[A-Za-z0-9_.:-]{16,255}$"
     },
     "context": {
-      "$ref": "/schemas/3.1.18/core/context.json"
+      "$ref": "/schemas/3.1.24/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.1.18/core/ext.json"
+      "$ref": "/schemas/3.1.24/core/ext.json"
     }
   },
   "required": [

package/dist/lib/schemas-data/3.1/media-buy/log-event-response.json

@@ -1,15 +1,15 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.18/media-buy/log-event-response.json",
+  "$id": "/schemas/3.1.24/media-buy/log-event-response.json",
   "title": "Log Event Response",
   "description": "Response from event logging operation. Returns either event processing results OR operation-level errors.",
   "type": "object",
   "allOf": [
     {
-      "$ref": "/schemas/3.1.18/core/version-envelope.json"
+      "$ref": "/schemas/3.1.24/core/version-envelope.json"
     },
     {
-      "$ref": "/schemas/3.1.18/core/protocol-envelope.json"
+      "$ref": "/schemas/3.1.24/core/protocol-envelope.json"
     }
   ],
   "oneOf": [
@@ -73,10 +73,10 @@
           "description": "When true, this response contains simulated data from sandbox mode."
         },
         "context": {
-          "$ref": "/schemas/3.1.18/core/context.json"
+          "$ref": "/schemas/3.1.24/core/context.json"
         },
         "ext": {
-          "$ref": "/schemas/3.1.18/core/ext.json"
+          "$ref": "/schemas/3.1.24/core/ext.json"
         }
       },
       "required": [
@@ -99,15 +99,15 @@
           "type": "array",
           "description": "Operation-level errors",
           "items": {
-            "$ref": "/schemas/3.1.18/core/error.json"
+            "$ref": "/schemas/3.1.24/core/error.json"
           },
           "minItems": 1
         },
         "context": {
-          "$ref": "/schemas/3.1.18/core/context.json"
+          "$ref": "/schemas/3.1.24/core/context.json"
         },
         "ext": {
-          "$ref": "/schemas/3.1.18/core/ext.json"
+          "$ref": "/schemas/3.1.24/core/ext.json"
         }
       },
       "required": [

package/dist/lib/schemas-data/3.1/media-buy/media-buy-delivery-webhook-result.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.18/media-buy/media-buy-delivery-webhook-result.json",
+  "$id": "/schemas/3.1.24/media-buy/media-buy-delivery-webhook-result.json",
   "title": "Media Buy Delivery Webhook Result",
   "description": "Payload-only delivery report result carried under core/mcp-webhook-payload.json result for task_type media_buy_delivery. This is not a top-level webhook POST body and does not include protocol envelope fields such as task_id or status.",
   "type": "object",
@@ -60,7 +60,7 @@
       "pattern": "^[A-Z]{3}$"
     },
     "attribution_window": {
-      "$ref": "/schemas/3.1.18/core/attribution-window.json",
+      "$ref": "/schemas/3.1.24/core/attribution-window.json",
       "description": "Attribution methodology and lookback windows used for conversion metrics in this report."
     },
     "media_buy_deliveries": {
@@ -109,12 +109,12 @@
             "description": "Timestamp when this row became final. Present only when is_final is true."
           },
           "pricing_model": {
-            "$ref": "/schemas/3.1.18/enums/pricing-model.json"
+            "$ref": "/schemas/3.1.24/enums/pricing-model.json"
           },
           "totals": {
             "allOf": [
               {
-                "$ref": "/schemas/3.1.18/core/delivery-metrics.json"
+                "$ref": "/schemas/3.1.24/core/delivery-metrics.json"
               },
               {
                 "type": "object",
@@ -138,7 +138,7 @@
             "items": {
               "allOf": [
                 {
-                  "$ref": "/schemas/3.1.18/core/delivery-metrics.json"
+                  "$ref": "/schemas/3.1.24/core/delivery-metrics.json"
                 },
                 {
                   "type": "object",
@@ -152,7 +152,7 @@
                       "minimum": 0
                     },
                     "pricing_model": {
-                      "$ref": "/schemas/3.1.18/enums/pricing-model.json"
+                      "$ref": "/schemas/3.1.24/enums/pricing-model.json"
                     },
                     "rate": {
                       "type": "number",
@@ -213,17 +213,17 @@
       "type": "array",
       "description": "Task-specific delivery errors or warnings.",
       "items": {
-        "$ref": "/schemas/3.1.18/core/error.json"
+        "$ref": "/schemas/3.1.24/core/error.json"
       }
     },
     "sandbox": {
       "type": "boolean"
     },
     "context": {
-      "$ref": "/schemas/3.1.18/core/context.json"
+      "$ref": "/schemas/3.1.24/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.1.18/core/ext.json"
+      "$ref": "/schemas/3.1.24/core/ext.json"
     }
   },
   "required": [

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

@@ -1,12 +1,12 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.18/media-buy/package-request.json",
+  "$id": "/schemas/3.1.24/media-buy/package-request.json",
   "title": "Package Request",
   "description": "Package configuration for media buy creation",
   "type": "object",
   "allOf": [
     {
-      "$ref": "/schemas/3.1.18/core/version-envelope.json"
+      "$ref": "/schemas/3.1.24/core/version-envelope.json"
     }
   ],
   "not": {
@@ -24,7 +24,7 @@
       "type": "array",
       "description": "Legacy named-format selector. Array of format IDs that will be used for this package - must be supported by the product. If omitted (and no 3.1+ format-option selector or direct canonical selector is present), defaults to all formats supported by the product.\n\nSellers comparing this selector to a product's `format_options[]` MUST first normalize each legacy `format_id` through the canonical mapping path (`canonical`, `v1_format_ref`, or registry projection). Exact `(agent_url, id)` comparison after projection is insufficient: a legacy fixed-size display ID can satisfy a canonical `image` product declaration with matching `width`/`height`. Product gating remains directional: if the product declares fixed dimensions or duration, the selected format must declare and match those constraints; an under-specified canonical request is not a wildcard for a fixed-size or fixed-duration product. Range constraints use containment, not overlap: a range-based request satisfies the product only when every value it permits falls within the product's accepted range.",
       "items": {
-        "$ref": "/schemas/3.1.18/core/format-id.json"
+        "$ref": "/schemas/3.1.24/core/format-id.json"
       },
       "minItems": 1
     },
@@ -32,12 +32,12 @@
       "type": "array",
       "description": "3.1+ format-option selector. Array of structured format option references, each matching one of the target product's `format_options[]` entries. Publisher-catalog-backed options match by `{ scope: \"publisher\", publisher_domain, format_option_id }`; product-local options match by `{ scope: \"product\", format_option_id }`. If omitted along with `format_ids` and direct `format_kind`, all product formats are active.\n\n**Resolution rules (normative).**\n- **Both `format_option_refs` and `format_ids` present.** `format_option_refs` wins; the seller routes by structured references and MUST NOT validate `format_ids` for consistency with the resolved declarations. The `format_ids` value is a legacy-compat hint for intermediaries on the wire path; the resolving seller ignores it.\n- **`format_option_refs` only.** Seller looks up each entry against the package's target product `format_options[]` and uses the matching declaration (and that declaration's `v1_format_ref[]` when projecting to legacy named-format surfaces). This is the 3.1+ format-option authoring path. `scope: \"product\"` is scoped only by this target product; it is not a seller-wide identifier.\n- **`format_ids` only.** Existing named-format behavior; unchanged.\n- **`format_kind` only.** Direct canonical selector behavior; seller compares `{ format_kind, params }` against the product's `format_options[]` declarations using directional product satisfaction.\n- **None of `format_option_refs`, `format_ids`, or `format_kind`.** Default — all formats supported by the product are active.\n\n**Failure modes (normative).** Sellers MUST reject with `UNSUPPORTED_FEATURE` (with `field` pointing at the failing package and entry, e.g. `packages[0].format_option_refs[1]`) when:\n- Any entry references a format option not present in the target product's `format_options[]`, OR\n- The target product carries `format_ids` but no `format_options[]` (legacy-format-only product — there is no closed set to resolve against), OR\n- The target product carries `format_options[]` but none of the entries publish selectable `format_option_id` values. Sellers SHOULD set `error.details.reason` to `format_option_refs_not_published` in this case so buyers can distinguish it from an outright mismatch and fall back to `format_ids[]`.\n\n**Seller obligation.** For buyers to use the 3.1+ format-option path against a product, the seller MUST publish a selectable `format_option_id` on each `format_options[]` entry it expects buyers to select; if the option is publisher-catalog backed, include `publisher_domain` on the product declaration and require buyers to use `scope: \"publisher\"` in `FormatOptionRef`.\n\n**No legacy capability selector.** `capability_ids` was removed before GA; schemas reject it instead of treating it as an extension.\n\n**Dual emission.** Format-option-aware buyer SDKs targeting a heterogeneous seller population SHOULD emit `format_ids` alongside `format_option_refs` so legacy-format-only sellers — which ignore unknown fields per `additionalProperties: true` — still receive an explicit format set rather than silently defaulting to all formats supported by the product.",
       "items": {
-        "$ref": "/schemas/3.1.18/core/format-option-ref.json"
+        "$ref": "/schemas/3.1.24/core/format-option-ref.json"
       },
       "minItems": 1
     },
     "format_kind": {
-      "$ref": "/schemas/3.1.18/core/canonical-format-kind.json",
+      "$ref": "/schemas/3.1.24/core/canonical-format-kind.json",
       "description": "3.1+ direct canonical selector. Names the canonical format shape this package targets when the buyer is authoring by canonical kind rather than by a product-local `format_option_ref` or legacy `format_id`. Pair with `params` when the product declaration requires dimensions, duration, sizes, codecs, or other canonical parameters. If `format_option_refs` is present, it wins over this direct selector. If `format_ids` is present without `format_option_refs`, sellers MUST normalize and validate the legacy selector; buyers SHOULD NOT also send `format_kind` unless it is an informational echo of the same normalized shape.\n\nProduct satisfaction is directional: a broad selector such as `{ format_kind: \"image\" }` does not satisfy a product whose `format_options[]` fixes `params.width` and `params.height`. Sellers MUST reject under-specified direct selectors with `UNSUPPORTED_FEATURE` or an equivalent format-selector validation error."
     },
     "params": {
@@ -51,7 +51,7 @@
       "minimum": 0
     },
     "pacing": {
-      "$ref": "/schemas/3.1.18/enums/pacing.json"
+      "$ref": "/schemas/3.1.24/enums/pacing.json"
     },
     "pricing_option_id": {
       "type": "string",
@@ -90,29 +90,29 @@
       "type": "array",
       "description": "Catalogs this package promotes. Each catalog MUST have a distinct type (e.g., one product catalog, one store catalog). This constraint is enforced at the application level — sellers MUST reject requests containing multiple catalogs of the same type with a validation_error. Makes the package catalog-driven: one budget envelope, platform optimizes across items.",
       "items": {
-        "$ref": "/schemas/3.1.18/core/catalog.json"
+        "$ref": "/schemas/3.1.24/core/catalog.json"
       }
     },
     "optimization_goals": {
       "type": "array",
       "description": "Optimization targets for this package. The seller optimizes delivery toward these goals in priority order. Common pattern: event goals (purchase, install) as primary targets at priority 1; metric goals (clicks, views) as secondary proxy signals at priority 2+.",
       "items": {
-        "$ref": "/schemas/3.1.18/core/optimization-goal.json"
+        "$ref": "/schemas/3.1.24/core/optimization-goal.json"
       },
       "minItems": 1
     },
     "targeting_overlay": {
-      "$ref": "/schemas/3.1.18/core/targeting.json"
+      "$ref": "/schemas/3.1.24/core/targeting.json"
     },
     "measurement_terms": {
-      "$ref": "/schemas/3.1.18/core/measurement-terms.json",
+      "$ref": "/schemas/3.1.24/core/measurement-terms.json",
       "description": "Buyer's proposed billing measurement and makegood terms. Overrides product defaults. Seller accepts (echoed on confirmed package), rejects with TERMS_REJECTED, or adjusts. When absent, product's measurement_terms apply."
     },
     "performance_standards": {
       "type": "array",
       "description": "Buyer's proposed performance standards for this package. Overrides product defaults. Seller accepts, rejects with TERMS_REJECTED, or adjusts. When absent, product's performance_standards apply.",
       "items": {
-        "$ref": "/schemas/3.1.18/core/performance-standard.json"
+        "$ref": "/schemas/3.1.24/core/performance-standard.json"
       },
       "minItems": 1
     },
@@ -133,7 +133,7 @@
                 "description": "Standard metric from the closed `available-metric.json` enum."
               },
               "metric_id": {
-                "$ref": "/schemas/3.1.18/enums/available-metric.json",
+                "$ref": "/schemas/3.1.24/enums/available-metric.json",
                 "description": "Identifier for the standard metric. MUST be present in the product's `reporting_capabilities.available_metrics`."
               },
               "qualifier": {
@@ -141,19 +141,19 @@
                 "description": "Disambiguator — same shape as on the response-side `committed_metrics`. Required when the buyer wants to pin a specific measurement path: `viewability_standard` for MRC vs GroupM viewability; `completion_source` for seller- vs vendor-attested `completion_rate`; `attribution_methodology` for how attribution was computed (deterministic_purchase, probabilistic, panel_based, modeled); `attribution_window` for the time window over which outcomes are attributed. See response-side description for full semantics.",
                 "properties": {
                   "viewability_standard": {
-                    "$ref": "/schemas/3.1.18/enums/viewability-standard.json"
+                    "$ref": "/schemas/3.1.24/enums/viewability-standard.json"
                   },
                   "completion_source": {
-                    "$ref": "/schemas/3.1.18/enums/completion-source.json"
+                    "$ref": "/schemas/3.1.24/enums/completion-source.json"
                   },
                   "attribution_methodology": {
-                    "$ref": "/schemas/3.1.18/enums/attribution-methodology.json"
+                    "$ref": "/schemas/3.1.24/enums/attribution-methodology.json"
                   },
                   "attribution_window": {
-                    "$ref": "/schemas/3.1.18/core/duration.json"
+                    "$ref": "/schemas/3.1.24/core/duration.json"
                   },
                   "lift_dimension": {
-                    "$ref": "/schemas/3.1.18/enums/lift-dimension.json"
+                    "$ref": "/schemas/3.1.24/enums/lift-dimension.json"
                   }
                 },
                 "additionalProperties": false
@@ -173,11 +173,11 @@
                 "description": "Vendor-defined metric, identified by the tuple `(vendor, metric_id)`."
               },
               "vendor": {
-                "$ref": "/schemas/3.1.18/core/brand-ref.json",
+                "$ref": "/schemas/3.1.24/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_id": {
-                "$ref": "/schemas/3.1.18/core/vendor-metric-id.json",
+                "$ref": "/schemas/3.1.24/core/vendor-metric-id.json",
                 "description": "Identifier for the metric within the vendor's vocabulary. MUST be present in the product's `reporting_capabilities.vendor_metrics` for the same vendor."
               }
             },
@@ -196,7 +196,7 @@
       "type": "array",
       "description": "Assign existing library creatives to this package with optional weights and placement targeting",
       "items": {
-        "$ref": "/schemas/3.1.18/core/creative-assignment.json"
+        "$ref": "/schemas/3.1.24/core/creative-assignment.json"
       },
       "minItems": 1
     },
@@ -204,7 +204,7 @@
       "type": "array",
       "description": "Upload creative assets inline and assign to this package. When the seller also advertises creative.has_creative_library: true, these creatives enter the seller's creative library and can be reused by creative_id while retained; inline-only sellers may store them as package-scoped assets. Use creative_assignments instead for existing library creatives.",
       "items": {
-        "$ref": "/schemas/3.1.18/core/creative-asset.json"
+        "$ref": "/schemas/3.1.24/core/creative-asset.json"
       },
       "minItems": 1,
       "maxItems": 100
@@ -215,11 +215,11 @@
       "description": "Agency estimate or authorization number for this package. Overrides the media buy-level estimate number when different packages correspond to different agency estimates (e.g., different stations or flights within the same buy)."
     },
     "context": {
-      "$ref": "/schemas/3.1.18/core/context.json",
+      "$ref": "/schemas/3.1.24/core/context.json",
       "description": "Opaque package-level correlation data echoed unchanged in the package response, webhooks, and read surfaces. Buyers targeting mixed seller populations SHOULD include a per-package correlation value here, commonly context.buyer_ref, so responses from legacy sellers that do not echo product_id can still be mapped back to the requested product or line item. Do not use deprecated top-level buyer_ref for v3 correlation."
     },
     "ext": {
-      "$ref": "/schemas/3.1.18/core/ext.json"
+      "$ref": "/schemas/3.1.24/core/ext.json"
     }
   },
   "required": [

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

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.18/media-buy/package-update.json",
+  "$id": "/schemas/3.1.24/media-buy/package-update.json",
   "title": "Package Update",
   "description": "Package update configuration for update_media_buy. Identifies package by package_id and specifies fields to modify. Fields not present are left unchanged. Fully-immutable fields (product_id, format_ids, format_option_refs, format_kind, params, pricing_option_id) cannot appear in update payloads — schema-enforced via the `not` constraint at the root of this object. Pre-GA `capability_ids` is also rejected rather than accepted as an extension. The reporting contract field `committed_metrics` is append-only (sellers MUST accept new entries on update but reject attempts to modify or remove existing entries with validation_error per its own description).",
   "type": "object",
@@ -16,7 +16,7 @@
       "minimum": 0
     },
     "pacing": {
-      "$ref": "/schemas/3.1.18/enums/pacing.json"
+      "$ref": "/schemas/3.1.24/enums/pacing.json"
     },
     "bid_price": {
       "type": "number",
@@ -59,7 +59,7 @@
       "type": "array",
       "description": "Replace the catalogs this package promotes. Uses replacement semantics — the provided array replaces the current list. Omit to leave catalogs unchanged.",
       "items": {
-        "$ref": "/schemas/3.1.18/core/catalog.json"
+        "$ref": "/schemas/3.1.24/core/catalog.json"
       },
       "minItems": 1
     },
@@ -67,12 +67,12 @@
       "type": "array",
       "description": "Replace all optimization goals for this package. Uses replacement semantics — omit to leave goals unchanged.",
       "items": {
-        "$ref": "/schemas/3.1.18/core/optimization-goal.json"
+        "$ref": "/schemas/3.1.24/core/optimization-goal.json"
       },
       "minItems": 1
     },
     "targeting_overlay": {
-      "$ref": "/schemas/3.1.18/core/targeting.json",
+      "$ref": "/schemas/3.1.24/core/targeting.json",
       "description": "Targeting overlay to apply to this package. Uses replacement semantics — the full overlay replaces the previous one. Omit to leave targeting unchanged. For keyword and negative keyword updates, prefer the incremental operations (keyword_targets_add, keyword_targets_remove, negative_keywords_add, negative_keywords_remove) which avoid replacing the full overlay. Sellers SHOULD return a validation error if targeting_overlay.keyword_targets is present in the same request as keyword_targets_add or keyword_targets_remove, and likewise for negative_keywords. If the replacement changes signal_targeting_groups, sellers MAY require a new quote or reject with REQUOTE_REQUIRED when the selected signal, group expression, or pricing_option_id changes the package's priced envelope."
     },
     "keyword_targets_add": {
@@ -87,7 +87,7 @@
             "description": "The keyword to target"
           },
           "match_type": {
-            "$ref": "/schemas/3.1.18/enums/match-type.json"
+            "$ref": "/schemas/3.1.24/enums/match-type.json"
           },
           "bid_price": {
             "type": "number",
@@ -115,7 +115,7 @@
             "description": "The keyword to stop targeting"
           },
           "match_type": {
-            "$ref": "/schemas/3.1.18/enums/match-type.json"
+            "$ref": "/schemas/3.1.24/enums/match-type.json"
           }
         },
         "required": [
@@ -138,7 +138,7 @@
             "description": "The keyword to exclude"
           },
           "match_type": {
-            "$ref": "/schemas/3.1.18/enums/match-type.json"
+            "$ref": "/schemas/3.1.24/enums/match-type.json"
           }
         },
         "required": [
@@ -161,7 +161,7 @@
             "description": "The keyword to stop excluding"
           },
           "match_type": {
-            "$ref": "/schemas/3.1.18/enums/match-type.json"
+            "$ref": "/schemas/3.1.24/enums/match-type.json"
           }
         },
         "required": [
@@ -176,23 +176,23 @@
       "type": "array",
       "description": "Replace creative assignments for this package with optional weights and placement targeting. Uses replacement semantics - omit to leave assignments unchanged.",
       "items": {
-        "$ref": "/schemas/3.1.18/core/creative-assignment.json"
+        "$ref": "/schemas/3.1.24/core/creative-assignment.json"
       }
     },
     "creatives": {
       "type": "array",
       "description": "Replace this package's inline creative assets. When the seller also advertises creative.has_creative_library: true, new inline creatives enter the seller's creative library and can be reused by creative_id while retained; inline-only sellers may store them as package-scoped assets. Use creative_assignments instead for existing library creatives.",
       "items": {
-        "$ref": "/schemas/3.1.18/core/creative-asset.json"
+        "$ref": "/schemas/3.1.24/core/creative-asset.json"
       },
       "minItems": 1,
       "maxItems": 100
     },
     "context": {
-      "$ref": "/schemas/3.1.18/core/context.json"
+      "$ref": "/schemas/3.1.24/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.1.18/core/ext.json"
+      "$ref": "/schemas/3.1.24/core/ext.json"
     }
   },
   "required": [

package/dist/lib/schemas-data/3.1/media-buy/provide-performance-feedback-request.json

@@ -1,12 +1,12 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.18/media-buy/provide-performance-feedback-request.json",
+  "$id": "/schemas/3.1.24/media-buy/provide-performance-feedback-request.json",
   "title": "Provide Performance Feedback Request",
   "description": "Request payload for provide_performance_feedback task",
   "type": "object",
   "allOf": [
     {
-      "$ref": "/schemas/3.1.18/core/version-envelope.json"
+      "$ref": "/schemas/3.1.24/core/version-envelope.json"
     }
   ],
   "x-mutates-state": true,
@@ -25,7 +25,7 @@
       "pattern": "^[A-Za-z0-9_.:-]{16,255}$"
     },
     "measurement_period": {
-      "$ref": "/schemas/3.1.18/core/datetime-range.json",
+      "$ref": "/schemas/3.1.24/core/datetime-range.json",
       "description": "Time period for performance measurement"
     },
     "performance_index": {
@@ -46,20 +46,20 @@
       "x-entity": "creative"
     },
     "metric_type": {
-      "$ref": "/schemas/3.1.18/enums/metric-type.json",
+      "$ref": "/schemas/3.1.24/enums/metric-type.json",
       "description": "The business metric being measured",
       "default": "overall_performance"
     },
     "feedback_source": {
-      "$ref": "/schemas/3.1.18/enums/feedback-source.json",
+      "$ref": "/schemas/3.1.24/enums/feedback-source.json",
       "description": "Source of the performance data",
       "default": "buyer_attribution"
     },
     "context": {
-      "$ref": "/schemas/3.1.18/core/context.json"
+      "$ref": "/schemas/3.1.24/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.1.18/core/ext.json"
+      "$ref": "/schemas/3.1.24/core/ext.json"
     }
   },
   "required": [