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

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

@@ -1,17 +1,17 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.18/media-buy/get-media-buys-request.json",
+  "$id": "/schemas/3.1.24/media-buy/get-media-buys-request.json",
   "title": "Get Media Buys Request",
   "description": "Request parameters for retrieving media buy status, creative approval state, and optional delivery snapshots",
   "type": "object",
   "allOf": [
     {
-      "$ref": "/schemas/3.1.18/core/version-envelope.json"
+      "$ref": "/schemas/3.1.24/core/version-envelope.json"
     }
   ],
   "properties": {
     "account": {
-      "$ref": "/schemas/3.1.18/core/account-ref.json",
+      "$ref": "/schemas/3.1.24/core/account-ref.json",
       "description": "Account to retrieve media buys for. When omitted, returns data across all accessible accounts."
     },
     "media_buy_ids": {
@@ -26,12 +26,12 @@
     "status_filter": {
       "oneOf": [
         {
-          "$ref": "/schemas/3.1.18/enums/media-buy-status.json"
+          "$ref": "/schemas/3.1.24/enums/media-buy-status.json"
         },
         {
           "type": "array",
           "items": {
-            "$ref": "/schemas/3.1.18/enums/media-buy-status.json"
+            "$ref": "/schemas/3.1.24/enums/media-buy-status.json"
           },
           "minItems": 1
         }
@@ -63,14 +63,14 @@
       "default": 50
     },
     "pagination": {
-      "$ref": "/schemas/3.1.18/core/pagination-request.json",
+      "$ref": "/schemas/3.1.24/core/pagination-request.json",
       "description": "Cursor-based pagination controls. Strongly recommended when querying broad scopes (for example, all active media buys in an account)."
     },
     "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/get-media-buys-response.json

@@ -1,15 +1,15 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.18/media-buy/get-media-buys-response.json",
+  "$id": "/schemas/3.1.24/media-buy/get-media-buys-response.json",
   "title": "Get Media Buys Response",
   "description": "Response payload for get_media_buys task. Returns media buy configuration, creative approval state, and optional delivery snapshots.",
   "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": {
@@ -25,15 +25,15 @@
             "x-entity": "media_buy"
           },
           "account": {
-            "$ref": "/schemas/3.1.18/core/account.json",
+            "$ref": "/schemas/3.1.24/core/account.json",
             "description": "Account billed for this media buy"
           },
           "invoice_recipient": {
-            "$ref": "/schemas/3.1.18/core/business-entity.json",
+            "$ref": "/schemas/3.1.24/core/business-entity.json",
             "description": "Per-buy invoice recipient when provided at creation. Confirms the seller accepted the billing override. Bank details are omitted (write-only)."
           },
           "status": {
-            "$ref": "/schemas/3.1.18/enums/media-buy-status.json"
+            "$ref": "/schemas/3.1.24/enums/media-buy-status.json"
           },
           "status_as_of": {
             "type": [
@@ -46,7 +46,7 @@
           "health": {
             "allOf": [
               {
-                "$ref": "/schemas/3.1.18/enums/media-buy-health.json"
+                "$ref": "/schemas/3.1.24/enums/media-buy-health.json"
               }
             ],
             "default": "ok",
@@ -56,7 +56,7 @@
             "type": "array",
             "description": "Open impairments — upstream dependency state changes that affect delivery for at least one package on this buy. Empty when `health` is `ok`; non-empty iff `health` is `impaired` (health-iff rule on non-terminal buys). Sellers MUST add an entry on the next read after a referenced resource transitions to an offline state, and MUST remove the entry when the resource returns to a serviceable state or stops being a dependency (e.g., via assignment swap via update_media_buy). Staleness budget: the snapshot MUST reflect the impairment within 5 minutes of `impairment.observed_at` regardless of buyer poll cadence — sellers cannot rely on rare buyer polls to defer write propagation. See impairment.coherence assertion for the cross-resource invariant.",
             "items": {
-              "$ref": "/schemas/3.1.18/core/impairment.json"
+              "$ref": "/schemas/3.1.24/core/impairment.json"
             }
           },
           "rejection_reason": {
@@ -110,7 +110,7 @@
                 "description": "ISO 8601 timestamp when this media buy was canceled."
               },
               "canceled_by": {
-                "$ref": "/schemas/3.1.18/enums/canceled-by.json",
+                "$ref": "/schemas/3.1.24/enums/canceled-by.json",
                 "description": "Which party initiated the cancellation."
               },
               "reason": {
@@ -137,21 +137,21 @@
             "description": "Last update timestamp"
           },
           "context": {
-            "$ref": "/schemas/3.1.18/core/context.json",
+            "$ref": "/schemas/3.1.24/core/context.json",
             "description": "Opaque media-buy-level correlation data echoed unchanged from the create_media_buy request. Sellers MUST include persisted context on read surfaces when the media buy was created through AdCP with context, so buyers can reconcile seller-assigned media_buy_id values with their own tracking state. Sellers MAY omit context for media buys created outside AdCP or created without context. Sellers MUST NOT parse this object for business logic."
           },
           "valid_actions": {
             "type": "array",
             "description": "Flat-vocabulary actions the buyer can perform on this media buy in its current state. Eliminates the need for agents to internalize the state machine — the seller declares what is permitted right now. Deprecated in favor of `available_actions[]`, which carries `mode` (self_serve / conditional_self_serve / requires_approval), 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.18/enums/media-buy-valid-action.json"
+              "$ref": "/schemas/3.1.24/enums/media-buy-valid-action.json"
             }
           },
           "available_actions": {
             "type": "array",
             "description": "Structured per-buy resolution of the actions buyer can perform right now. Authoritative — divergence from product `allowed_actions[]` is expected (negotiated terms, account tier, buy-level overrides live on the deal, not the product). Each entry carries the resolved `mode` (singular, since the buy has a concrete state), optional `sla` commitment, and optional `terms_ref`. Predicate queries via #4425's `requires` grammar address fields by dotted path, e.g. `available_actions.extend_flight.sla.response_max`. Absent SLA means no commitment, not zero commitment — callers composing duration predicates MUST also compose with `present: true` to avoid silently matching sellers who never declared one.",
             "items": {
-              "$ref": "/schemas/3.1.18/core/media-buy-available-action.json"
+              "$ref": "/schemas/3.1.24/core/media-buy-available-action.json"
             },
             "uniqueItems": true
           },
@@ -159,7 +159,7 @@
             "type": "array",
             "description": "Recent reporting and health webhook fires for the calling principal, most-recent first. Present only when `include_webhook_activity` was true in the request AND the seller surfaces this debug capability for this buy. Three-state semantics: (a) field omitted — seller does not surface webhook activity (either does not persist fire history, or `capabilities.media_buy.propagation_surfaces` excludes webhook surfaces, or the buy has no registered `push_notification_config` for this principal); (b) empty array `[]` — seller persists fire history but has fired nothing recent for this principal; (c) non-empty array — actual fire records. Sellers whose declared `propagation_surfaces` does not include `webhook` MUST omit the field. **Retention (normative):** sellers that surface this field MUST retain records for at least 30 days from each record's `completed_at` (for records still in `pending` status the clock runs from `fired_at` until the attempt terminates, then resets to 30 days from `completed_at` — so retry trails do not age out mid-flight). Sellers that cannot honor the 30-day floor MUST omit the field entirely rather than return a shorter window. Sellers MAY return fewer than `webhook_activity_limit` records when fewer fire records exist within the retention window. Sellers MUST emit one record per attempt — single-attempt successes appear as a single record with `attempt: 1`. Record shape is canonical across resources: see [`/schemas/core/webhook-activity-record.json`](/schemas/v3/core/webhook-activity-record.json) and snapshot-and-log.mdx § Webhook activity log pattern.",
             "items": {
-              "$ref": "/schemas/3.1.18/core/webhook-activity-record.json"
+              "$ref": "/schemas/3.1.24/core/webhook-activity-record.json"
             },
             "maxItems": 200
           },
@@ -198,7 +198,7 @@
                   "x-entity": "package"
                 },
                 "ext": {
-                  "$ref": "/schemas/3.1.18/core/ext.json"
+                  "$ref": "/schemas/3.1.24/core/ext.json"
                 }
               },
               "required": [
@@ -246,7 +246,7 @@
                   "type": "array",
                   "description": "Legacy named-format IDs supplied for this package on create_media_buy. Sellers SHOULD echo this field whenever the request included it, including dual-emission cases where another selector won precedence.",
                   "items": {
-                    "$ref": "/schemas/3.1.18/core/format-id.json"
+                    "$ref": "/schemas/3.1.24/core/format-id.json"
                   },
                   "minItems": 1
                 },
@@ -254,12 +254,12 @@
                   "type": "array",
                   "description": "Structured 3.1+ format option references supplied for this package on create_media_buy. Sellers SHOULD echo this field whenever the request included it.",
                   "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": "Direct canonical selector supplied for this package on create_media_buy. Sellers SHOULD echo this field whenever the request included it, including informational-echo cases where another selector won precedence."
                 },
                 "params": {
@@ -273,7 +273,7 @@
                   "minimum": 0
                 },
                 "targeting_overlay": {
-                  "$ref": "/schemas/3.1.18/core/targeting.json",
+                  "$ref": "/schemas/3.1.24/core/targeting.json",
                   "description": "Targeting overlay applied to this package, echoed from the most recent create_media_buy or update_media_buy. Sellers SHOULD echo any persisted targeting so buyers can verify what was stored without replaying their own request. Sellers claiming the property-lists or collection-lists specialisms MUST include, within this targeting_overlay, the PropertyListReference / CollectionListReference they persisted."
                 },
                 "start_time": {
@@ -308,7 +308,7 @@
                       "description": "ISO 8601 timestamp when this package was canceled."
                     },
                     "canceled_by": {
-                      "$ref": "/schemas/3.1.18/enums/canceled-by.json",
+                      "$ref": "/schemas/3.1.24/enums/canceled-by.json",
                       "description": "Which party initiated the package cancellation."
                     },
                     "reason": {
@@ -325,7 +325,7 @@
                   "description": "ISO 8601 timestamp for creative upload or change deadline for this package. After this deadline, creative changes are rejected. When absent, the media buy's creative_deadline applies."
                 },
                 "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 from the create_media_buy package request. Sellers MUST include persisted package context on read surfaces when the package was created through AdCP with context, so buyers can reconcile seller-assigned package_id values with their own line items; this is the legacy-safe fallback when an older seller did not echo product_id on the create response. Sellers MAY omit context for packages created outside AdCP or created without context. Sellers MUST NOT parse this object for business logic."
                 },
                 "creative_approvals": {
@@ -340,7 +340,7 @@
                         "x-entity": "creative"
                       },
                       "approval_status": {
-                        "$ref": "/schemas/3.1.18/enums/creative-approval-status.json"
+                        "$ref": "/schemas/3.1.24/enums/creative-approval-status.json"
                       },
                       "rejection_reason": {
                         "type": "string",
@@ -358,11 +358,11 @@
                   "type": "array",
                   "description": "Format IDs from the original create_media_buy format_ids_to_provide that have not yet been uploaded via sync_creatives. When empty or absent, all required formats have been provided.",
                   "items": {
-                    "$ref": "/schemas/3.1.18/core/format-id.json"
+                    "$ref": "/schemas/3.1.24/core/format-id.json"
                   }
                 },
                 "snapshot_unavailable_reason": {
-                  "$ref": "/schemas/3.1.18/enums/snapshot-unavailable-reason.json",
+                  "$ref": "/schemas/3.1.24/enums/snapshot-unavailable-reason.json",
                   "description": "Machine-readable reason the snapshot is omitted. Present only when include_snapshot was true and snapshot is unavailable for this package."
                 },
                 "snapshot": {
@@ -417,7 +417,7 @@
                       ]
                     },
                     "ext": {
-                      "$ref": "/schemas/3.1.18/core/ext.json",
+                      "$ref": "/schemas/3.1.24/core/ext.json",
                       "description": "Optional extension object for seller-specific snapshot fields."
                     }
                   },
@@ -430,7 +430,7 @@
                   "additionalProperties": true
                 },
                 "ext": {
-                  "$ref": "/schemas/3.1.18/core/ext.json"
+                  "$ref": "/schemas/3.1.24/core/ext.json"
                 }
               },
               "required": [
@@ -445,7 +445,7 @@
             }
           },
           "ext": {
-            "$ref": "/schemas/3.1.18/core/ext.json"
+            "$ref": "/schemas/3.1.24/core/ext.json"
           }
         },
         "allOf": [
@@ -502,11 +502,11 @@
       "type": "array",
       "description": "Task-specific errors (e.g., media buy not found)",
       "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",
       "description": "Pagination metadata for the media_buys array."
     },
     "sandbox": {
@@ -514,10 +514,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": [

package/dist/lib/schemas-data/3.1/media-buy/get-products-async-response-input-required.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.18/media-buy/get-products-async-response-input-required.json",
+  "$id": "/schemas/3.1.24/media-buy/get-products-async-response-input-required.json",
   "title": "Get Products - Input Required",
   "description": "Payload when search is paused waiting for user clarification.",
   "type": "object",
@@ -17,7 +17,7 @@
       "type": "array",
       "description": "Partial product results that may help inform the clarification",
       "items": {
-        "$ref": "/schemas/3.1.18/core/product.json"
+        "$ref": "/schemas/3.1.24/core/product.json"
       }
     },
     "suggestions": {
@@ -28,10 +28,10 @@
       }
     },
     "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/get-products-async-response-submitted.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.18/media-buy/get-products-async-response-submitted.json",
+  "$id": "/schemas/3.1.24/media-buy/get-products-async-response-submitted.json",
   "title": "Get Products - Submitted",
   "description": "Async task envelope returned when get_products cannot be confirmed before the response — for example, when custom or bespoke product curation is queued for processing. This envelope is valid only for `buying_mode: \"brief\"` and `buying_mode: \"refine\"`; `buying_mode: \"wholesale\"` is a synchronous wholesale product feed read and MUST NOT use the Submitted arm. The buyer can always poll `get_task_status` (legacy `tasks/get`) with `task_id`. If the originating request carried `push_notification_config`, the seller also delivers at least the terminal completion/failure notification to that webhook URL; intermediate progress notifications are MAY. The products array lands on the completion artifact, not this envelope.",
   "type": "object",
@@ -29,14 +29,14 @@
       "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.18/core/error.json"
+        "$ref": "/schemas/3.1.24/core/error.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"
     }
   },
   "required": [

package/dist/lib/schemas-data/3.1/media-buy/get-products-async-response-working.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.18/media-buy/get-products-async-response-working.json",
+  "$id": "/schemas/3.1.24/media-buy/get-products-async-response-working.json",
   "title": "Get Products - Working",
   "description": "Progress payload for active get_products task.",
   "type": "object",
@@ -24,10 +24,10 @@
       "description": "Current step number (1-indexed)"
     },
     "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/get-products-request.json

@@ -1,12 +1,12 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.18/media-buy/get-products-request.json",
+  "$id": "/schemas/3.1.24/media-buy/get-products-request.json",
   "title": "Get Products Request",
   "description": "Request parameters for discovering or refining advertising products. buying_mode declares the buyer's intent: 'brief' for curated discovery, 'wholesale' for raw wholesale product feed access, or 'refine' to iterate on known products and proposals.",
   "type": "object",
   "allOf": [
     {
-      "$ref": "/schemas/3.1.18/core/version-envelope.json"
+      "$ref": "/schemas/3.1.24/core/version-envelope.json"
     },
     {
       "description": "Conditional wholesale feed version requests are only valid for wholesale product feed reads.",
@@ -37,6 +37,13 @@
     }
   ],
   "properties": {
+    "idempotency_key": {
+      "type": "string",
+      "description": "Optional client-generated key on the AdCP 3.x compatibility facade. The field remains optional on every arm for wire compatibility. A seller MAY ignore a supplied key on a guaranteed side-effect-free synchronous read. Buyers SHOULD supply a key whenever the request may allocate a task, finalize a proposal, or otherwise change observable state. When a key is supplied on such a request and the seller declares adcp.idempotency.supported: true, the seller MUST apply the AdCP replay contract before that effect. If the key is omitted or the seller declares adcp.idempotency.supported: false, the buyer has no portable at-most-once retry guarantee after an ambiguous result. Keys MUST be unique per seller and logical request.",
+      "minLength": 16,
+      "maxLength": 255,
+      "pattern": "^[A-Za-z0-9_.:-]{16,255}$"
+    },
     "buying_mode": {
       "type": "string",
       "enum": [
@@ -151,31 +158,31 @@
       }
     },
     "brand": {
-      "$ref": "/schemas/3.1.18/core/brand-ref.json",
+      "$ref": "/schemas/3.1.24/core/brand-ref.json",
       "description": "Brand reference for product discovery context. Resolved to full brand identity at execution time."
     },
     "catalog": {
-      "$ref": "/schemas/3.1.18/core/catalog.json",
+      "$ref": "/schemas/3.1.24/core/catalog.json",
       "description": "Catalog of items the buyer wants to promote. The seller matches catalog items against its inventory and returns products where matches exist. Supports all catalog types: a job catalog finds job ad products, a product catalog finds sponsored product slots. Reference a synced catalog by catalog_id, or provide inline items."
     },
     "account": {
-      "$ref": "/schemas/3.1.18/core/account-ref.json",
+      "$ref": "/schemas/3.1.24/core/account-ref.json",
       "description": "Account for product lookup. Returns products with pricing specific to this account's rate card."
     },
     "preferred_delivery_types": {
       "type": "array",
       "description": "Delivery types the buyer prefers, in priority order. Unlike filters.delivery_type which excludes non-matching products, this signals preference for curation — the publisher may still include other delivery types when they match the brief well.",
       "items": {
-        "$ref": "/schemas/3.1.18/enums/delivery-type.json"
+        "$ref": "/schemas/3.1.24/enums/delivery-type.json"
       },
       "minItems": 1,
       "uniqueItems": true
     },
     "filters": {
-      "$ref": "/schemas/3.1.18/core/product-filters.json"
+      "$ref": "/schemas/3.1.24/core/product-filters.json"
     },
     "property_list": {
-      "$ref": "/schemas/3.1.18/core/property-list-ref.json",
+      "$ref": "/schemas/3.1.24/core/property-list-ref.json",
       "description": "[AdCP 3.0] Reference to an externally managed property list. When provided, the sales agent should filter products to only those available on properties in the list."
     },
     "fields": {
@@ -230,17 +237,17 @@
     "time_budget": {
       "allOf": [
         {
-          "$ref": "/schemas/3.1.18/core/duration.json"
+          "$ref": "/schemas/3.1.24/core/duration.json"
         }
       ],
       "description": "Maximum time the buyer will commit to this request. The seller returns the best results achievable within this budget and does not start processes (human approvals, expensive external queries) that cannot complete in time. When omitted, the seller decides timing."
     },
     "push_notification_config": {
-      "$ref": "/schemas/3.1.18/core/push-notification-config.json",
+      "$ref": "/schemas/3.1.24/core/push-notification-config.json",
       "description": "Optional webhook configuration for async terminal completion/failure notifications on curated discovery. Meaningful only for `buying_mode: \"brief\"` and `buying_mode: \"refine\"` requests that enter the async lifecycle. Submitted envelopes with `task_id` remain pollable through `get_task_status` (legacy `tasks/get`) whether or not this field is present. If a brief/refine request includes this field and the seller returns a Submitted envelope, the seller MUST deliver at least the terminal completion/failure notification to the configured URL; intermediate progress notifications are MAY. If the seller cannot honor the webhook channel, it MUST reject the request with a structured error instead of silently accepting. This field does not change wholesale timing semantics: sellers MUST NOT route `buying_mode: \"wholesale\"` requests through the async/Submitted arm or emit async delivery solely because `push_notification_config` is present; partial wholesale completion is reported via `incomplete[]`."
     },
     "pagination": {
-      "$ref": "/schemas/3.1.18/core/pagination-request.json",
+      "$ref": "/schemas/3.1.24/core/pagination-request.json",
       "description": "Cursor-based pagination controls for get_products. Valid in all buying modes. In brief mode, pagination bounds the seller's returned products[] for the curated answer to the brief and is not an exhaustive catalog-enumeration contract. In refine mode, pagination bounds the refined products[] result implied by refine[] and filters; proposals may accompany a page as plan metadata but are not independently counted by this pagination envelope. In wholesale mode, pagination walks the wholesale product feed and may be combined with wholesale feed versioning."
     },
     "if_wholesale_feed_version": {
@@ -252,7 +259,7 @@
       "description": "Opaque pricing_version token from a prior get_products response. MUST only be sent together with if_wholesale_feed_version — pricing version has no structural baseline to compare against on its own. Evaluation order: (1) if_wholesale_feed_version mismatch → seller returns the full payload (pricing is implicitly stale); (2) if_wholesale_feed_version matches but if_pricing_version mismatches → seller returns the full payload so the buyer sees updated pricing_options; (3) both match → seller MAY return unchanged: true. Agents that don't track pricing separately ignore if_pricing_version and fall back to if_wholesale_feed_version semantics. Useful for storefronts that re-price compositions far more often than they re-render product mirrors."
     },
     "context": {
-      "$ref": "/schemas/3.1.18/core/context.json"
+      "$ref": "/schemas/3.1.24/core/context.json"
     },
     "required_policies": {
       "type": "array",
@@ -262,7 +269,7 @@
       "description": "Registry policy IDs that the buyer requires to be enforced for products in this response. Sellers filter products to only those that comply with or already enforce the requested policies."
     },
     "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/get-products-response.json

@@ -1,15 +1,15 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.18/media-buy/get-products-response.json",
+  "$id": "/schemas/3.1.24/media-buy/get-products-response.json",
   "title": "Get Products Response",
   "description": "Response payload for get_products 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": "Array of matching products",
       "items": {
-        "$ref": "/schemas/3.1.18/core/product.json"
+        "$ref": "/schemas/3.1.24/core/product.json"
       }
     },
     "extensions": {
@@ -56,14 +56,14 @@
       "type": "array",
       "description": "Optional array of proposed media plans with budget allocations across products. Publishers include proposals when they can provide strategic guidance based on the brief. Proposals are actionable - buyers can refine them via follow-up get_products calls within the same session, or execute them directly via create_media_buy.",
       "items": {
-        "$ref": "/schemas/3.1.18/core/proposal.json"
+        "$ref": "/schemas/3.1.24/core/proposal.json"
       }
     },
     "errors": {
       "type": "array",
       "description": "Task-specific errors and warnings (e.g., product filtering issues)",
       "items": {
-        "$ref": "/schemas/3.1.18/core/error.json"
+        "$ref": "/schemas/3.1.24/core/error.json"
       }
     },
     "property_list_applied": {
@@ -202,7 +202,7 @@
           "estimated_wait": {
             "allOf": [
               {
-                "$ref": "/schemas/3.1.18/core/duration.json"
+                "$ref": "/schemas/3.1.24/core/duration.json"
               }
             ],
             "description": "How much additional time would resolve this scope. Allows the buyer to decide whether to retry with a larger time_budget."
@@ -299,7 +299,7 @@
       ]
     },
     "pagination": {
-      "$ref": "/schemas/3.1.18/core/pagination-response.json",
+      "$ref": "/schemas/3.1.24/core/pagination-response.json",
       "description": "Cursor metadata for paginated get_products responses. In brief/refine mode, continuation pages bound returned products[] for the seller's curated or refined answer; proposals may accompany a page as plan metadata but are not independently counted by this pagination envelope, and pagination does not convert the response into an exhaustive feed contract. In wholesale mode, continuation pages walk the wholesale product feed."
     },
     "wholesale_feed_version": {
@@ -338,10 +338,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"
     }
   },
   "if": {