@adcp/sdk 13.0.0 → 13.0.2

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

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/bundled/media-buy/get-products-response.json",
+  "$id": "/schemas/3.1.20/bundled/media-buy/get-products-response.json",
   "title": "Get Products Response",
   "description": "Response payload for get_products task",
   "type": "object",
@@ -28,7 +28,7 @@
           "maximum": 99
         }
       },
-      "$id": "/schemas/3.1.15/core/version-envelope.json"
+      "$id": "/schemas/3.1.20/core/version-envelope.json"
     },
     {
       "title": "Protocol Envelope",
@@ -44,7 +44,7 @@
           "description": "Per-request opaque caller-supplied correlation object echoed unchanged in the response. Used for buyer-side tracking (UI session IDs, trace IDs, custom metadata) that the agent MUST preserve byte-for-byte without parsing. Distinct from `context_id` (server-managed session identifier) — `context` is caller-owned echo, `context_id` is server-owned session scope. Both MAY appear on the same response.\n\n**Relationship to per-task body-level `context` declarations.** Many task request/response schemas (147 as of 3.1) already declare a body-level `context` field that `$ref`s `/schemas/core/context.json` at the body root. Under the flat-on-the-wire MCP serialization (see `notes` below), envelope-level `context` and body-level `context` occupy the same key on the response root — they are NOT separate fields, they MUST share the same value, and they MUST both `$ref` `core/context.json`. The envelope declaration is **authoritative** for the schema definition; per-task body declarations are mirrors retained for tooling reasons (SDK codegen completeness, per-task validation against the response schema in isolation). Future versions MAY drop body-level `context` declarations from per-task schemas; conformance does not require either declaration to be present, only that the wire value `$ref`s `core/context.json`.",
           "type": "object",
           "additionalProperties": true,
-          "$id": "/schemas/3.1.15/core/context.json"
+          "$id": "/schemas/3.1.20/core/context.json"
         },
         "task_id": {
           "type": "string",
@@ -77,7 +77,7 @@
             "auth-required": "Task requires authentication to proceed",
             "unknown": "Task is in an unknown or indeterminate state"
           },
-          "$id": "/schemas/3.1.15/enums/task-status.json"
+          "$id": "/schemas/3.1.20/enums/task-status.json"
         },
         "message": {
           "type": "string",
@@ -216,7 +216,7 @@
             "message"
           ],
           "additionalProperties": true,
-          "$id": "/schemas/3.1.15/core/error.json"
+          "$id": "/schemas/3.1.20/core/error.json"
         },
         "push_notification_config": {
           "title": "Push Notification Config",
@@ -256,7 +256,7 @@
                       "Bearer",
                       "HMAC-SHA256"
                     ],
-                    "$id": "/schemas/3.1.15/enums/auth-scheme.json"
+                    "$id": "/schemas/3.1.20/enums/auth-scheme.json"
                   },
                   "minItems": 1,
                   "maxItems": 1
@@ -277,7 +277,7 @@
           "required": [
             "url"
           ],
-          "$id": "/schemas/3.1.15/core/push-notification-config.json"
+          "$id": "/schemas/3.1.20/core/push-notification-config.json"
         },
         "governance_context": {
           "type": "string",
@@ -427,7 +427,7 @@
         "`status` is REQUIRED on the conceptual envelope across all transports. On MCP and REST it appears as a sibling field at the JSON root (or `structuredContent` root for MCP); on A2A the canonical carrier is `task.status.state`, which maps 1:1 to this `status` value — receivers MUST extract A2A's `task.status.state` into the in-memory envelope `status` per the canonical extraction algorithm. The schema-level `required: [status]` enforces the post-extraction in-memory shape; the transport-native form satisfies the requirement on each wire. `payload` remains intentionally NOT required — it is a documentary grouping construct, never a required wire field. See `mcp-guide.mdx` and `a2a-guide.mdx` for the wire-level patterns receivers MUST implement.",
         "Receivers MUST handle absence of an envelope field (e.g., `replayed` omitted) as the field's documented default — see each field's `default` clause."
       ],
-      "$id": "/schemas/3.1.15/core/protocol-envelope.json"
+      "$id": "/schemas/3.1.20/core/protocol-envelope.json"
     }
   ],
   "properties": {
@@ -547,7 +547,7 @@
                               "mobile_ios",
                               "instagram"
                             ],
-                            "$id": "/schemas/3.1.15/core/property-id.json"
+                            "$id": "/schemas/3.1.20/core/property-id.json"
                           },
                           "minItems": 1
                         }
@@ -599,7 +599,7 @@
                               "meta_network",
                               "social_media"
                             ],
-                            "$id": "/schemas/3.1.15/core/property-tag.json"
+                            "$id": "/schemas/3.1.20/core/property-tag.json"
                           },
                           "minItems": 1
                         }
@@ -635,7 +635,7 @@
                       "additionalProperties": true
                     }
                   ],
-                  "$id": "/schemas/3.1.15/core/publisher-property-selector.json"
+                  "$id": "/schemas/3.1.20/core/publisher-property-selector.json"
                 },
                 {
                   "not": {
@@ -704,7 +704,7 @@
                   "width"
                 ]
               },
-              "$id": "/schemas/3.1.15/core/format-id.json"
+              "$id": "/schemas/3.1.20/core/format-id.json"
             }
           },
           "format_options": {
@@ -846,7 +846,7 @@
                       "digest": "sha256:a3f5b7c9d8e2f1a4b6c8d0e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d6e8f0a2"
                     }
                   ],
-                  "$id": "/schemas/3.1.15/core/platform-extension-ref.json"
+                  "$id": "/schemas/3.1.20/core/platform-extension-ref.json"
                 }
               },
               "allOf": [
@@ -1420,7 +1420,7 @@
                                     "authorization_instructions": "Connect the creator or page that owns the source post."
                                   }
                                 ],
-                                "$id": "/schemas/3.1.15/core/downstream-connection-requirement.json"
+                                "$id": "/schemas/3.1.20/core/downstream-connection-requirement.json"
                               },
                               "description": "Downstream platform connections or grants required to use this format declaration. These are in addition to the single AdCP caller credential. Use this when a platform product requires multiple downstream grants, such as an advertiser account connection plus a publisher identity or post authorization for published-post references."
                             },
@@ -18276,7 +18276,7 @@
               "guaranteed": "Reserved inventory with guaranteed delivery",
               "non_guaranteed": "Inventory without reserved or guaranteed delivery, commonly auction-based or otherwise best-effort. Do not use for scheduled broadcast buys solely because final audience delivery is estimated from historical ranges or settles through third-party measurement."
             },
-            "$id": "/schemas/3.1.15/enums/delivery-type.json"
+            "$id": "/schemas/3.1.20/enums/delivery-type.json"
           },
           "exclusivity": {
             "title": "Exclusivity",
@@ -18292,7 +18292,7 @@
               "category": "Category-exclusive — only one advertiser per industry category (e.g., one auto brand per collection sponsorship)",
               "exclusive": "Sole sponsorship — only one advertiser can buy this product"
             },
-            "$id": "/schemas/3.1.15/enums/exclusivity.json"
+            "$id": "/schemas/3.1.20/enums/exclusivity.json"
           },
           "pricing_options": {
             "type": "array",
@@ -18371,7 +18371,7 @@
                         }
                       },
                       "additionalProperties": true,
-                      "$id": "/schemas/3.1.15/pricing-options/price-guidance.json"
+                      "$id": "/schemas/3.1.20/pricing-options/price-guidance.json"
                     },
                     "min_spend_per_package": {
                       "type": "number",
@@ -20385,7 +20385,7 @@
                                   "placement_id"
                                 ],
                                 "additionalProperties": true,
-                                "$id": "/schemas/3.1.15/core/placement-ref.json"
+                                "$id": "/schemas/3.1.20/core/placement-ref.json"
                               },
                               "placement_name": {
                                 "type": "string",
@@ -20397,7 +20397,7 @@
                               "placement_ref"
                             ],
                             "additionalProperties": false,
-                            "$id": "/schemas/3.1.15/core/forecast-dimension-placement.json"
+                            "$id": "/schemas/3.1.20/core/forecast-dimension-placement.json"
                           },
                           {
                             "title": "Device Type Forecast Dimension",
@@ -20640,7 +20640,7 @@
                                     "additionalProperties": true
                                   }
                                 ],
-                                "$id": "/schemas/3.1.15/core/signal-ref.json"
+                                "$id": "/schemas/3.1.20/core/signal-ref.json"
                               },
                               "signal_id": {
                                 "type": "string",
@@ -20738,7 +20738,7 @@
                               }
                             ],
                             "additionalProperties": false,
-                            "$id": "/schemas/3.1.15/core/forecast-dimension-signal.json"
+                            "$id": "/schemas/3.1.20/core/forecast-dimension-signal.json"
                           }
                         ]
                       }
@@ -20782,7 +20782,7 @@
                             }
                           ],
                           "additionalProperties": true,
-                          "$id": "/schemas/3.1.15/core/forecast-range.json"
+                          "$id": "/schemas/3.1.20/core/forecast-range.json"
                         },
                         "reach": {
                           "title": "Forecast Range",
@@ -21443,7 +21443,7 @@
                                 "nike",
                                 "pampers"
                               ],
-                              "$id": "/schemas/3.1.15/core/brand-id.json"
+                              "$id": "/schemas/3.1.20/core/brand-id.json"
                             },
                             "industries": {
                               "type": "array",
@@ -21788,7 +21788,7 @@
                                                         "description": "Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.",
                                                         "type": "object",
                                                         "additionalProperties": true,
-                                                        "$id": "/schemas/3.1.15/core/ext.json"
+                                                        "$id": "/schemas/3.1.20/core/ext.json"
                                                       }
                                                     },
                                                     "additionalProperties": true
@@ -22642,7 +22642,7 @@
                               "co_view_index",
                               "incremental_lift_percent"
                             ],
-                            "$id": "/schemas/3.1.15/core/vendor-metric-id.json"
+                            "$id": "/schemas/3.1.20/core/vendor-metric-id.json"
                           },
                           "value": {
                             "title": "Forecast Range",
@@ -22889,7 +22889,7 @@
                       "unit"
                     ],
                     "additionalProperties": false,
-                    "$id": "/schemas/3.1.15/core/duration.json"
+                    "$id": "/schemas/3.1.20/core/duration.json"
                   }
                 ],
                 "description": "Attribution window as a structured duration (e.g., {\"interval\": 30, \"unit\": \"days\"})."
@@ -22909,7 +22909,7 @@
               "reporting"
             ],
             "additionalProperties": true,
-            "$id": "/schemas/3.1.15/core/outcome-measurement.json"
+            "$id": "/schemas/3.1.20/core/outcome-measurement.json"
           },
           "delivery_measurement": {
             "type": "object",
@@ -23987,7 +23987,7 @@
                         "credit": "Seller issues a credit toward future media buys on the same account.",
                         "invoice_adjustment": "Seller reduces the invoice for the current media buy to reflect actual delivered value."
                       },
-                      "$id": "/schemas/3.1.15/enums/makegood-remedy.json"
+                      "$id": "/schemas/3.1.20/enums/makegood-remedy.json"
                     },
                     "minItems": 1,
                     "uniqueItems": true
@@ -24027,7 +24027,7 @@
                     "brand_safety": "Brand-safe impression rate (floor — must exceed threshold). Denominator: total_impressions.",
                     "attention_score": "Attention score rate (floor — must exceed threshold). Denominator: measurable_impressions."
                   },
-                  "$id": "/schemas/3.1.15/enums/performance-standard-metric.json"
+                  "$id": "/schemas/3.1.20/enums/performance-standard-metric.json"
                 },
                 "threshold": {
                   "type": "number",
@@ -24654,7 +24654,7 @@
               "cancellation_fee"
             ],
             "additionalProperties": true,
-            "$id": "/schemas/3.1.15/core/cancellation-policy.json"
+            "$id": "/schemas/3.1.20/core/cancellation-policy.json"
           },
           "allowed_actions": {
             "type": "array",
@@ -24866,7 +24866,7 @@
                       ]
                     }
                   },
-                  "$id": "/schemas/3.1.15/enums/media-buy-valid-action.json"
+                  "$id": "/schemas/3.1.20/enums/media-buy-valid-action.json"
                 },
                 "modes": {
                   "type": "array",
@@ -24886,7 +24886,7 @@
                       "conditional_self_serve": "Seller auto-approves within declared tolerances and escalates outside them. Covers programmatic guaranteed flows on platforms like FreeWheel, Magnite, and GAM where small mutations clear automatically but large ones queue for human review. Constraint metadata defining the tolerances is out of scope for v1 and the natural home is #4425's `requires` predicate grammar; until #4425 lands, tolerances are declared out-of-band and buyers cannot statically predict which mutations will auto-approve from this surface alone.",
                       "requires_approval": "Human-in-the-loop, asynchronous, no proposal artifact. Buyer SDK should expect a pending-status poll or webhook callback when the seller's operator approves or rejects."
                     },
-                    "$id": "/schemas/3.1.15/enums/media-buy-action-mode.json"
+                    "$id": "/schemas/3.1.20/enums/media-buy-action-mode.json"
                   },
                   "minItems": 1,
                   "uniqueItems": true
@@ -24916,7 +24916,7 @@
                       "rejected": "Media buy was declined by the seller after creation",
                       "canceled": "Media buy was terminated before natural completion. Check cancellation.canceled_by to determine whether the buyer or seller initiated."
                     },
-                    "$id": "/schemas/3.1.15/enums/media-buy-status.json"
+                    "$id": "/schemas/3.1.20/enums/media-buy-status.json"
                   },
                   "minItems": 1,
                   "uniqueItems": true
@@ -24948,7 +24948,7 @@
                     }
                   },
                   "additionalProperties": false,
-                  "$id": "/schemas/3.1.15/core/sla-window.json"
+                  "$id": "/schemas/3.1.20/core/sla-window.json"
                 },
                 "terms_ref": {
                   "type": "string",
@@ -24960,7 +24960,7 @@
                 "modes"
               ],
               "additionalProperties": false,
-              "$id": "/schemas/3.1.15/core/product-allowed-action.json"
+              "$id": "/schemas/3.1.20/core/product-allowed-action.json"
             },
             "minItems": 1,
             "uniqueItems": true
@@ -25048,7 +25048,7 @@
                     "conversion_lift",
                     "brand_search_lift"
                   ],
-                  "$id": "/schemas/3.1.15/enums/available-metric.json"
+                  "$id": "/schemas/3.1.20/enums/available-metric.json"
                 },
                 "uniqueItems": true,
                 "examples": [
@@ -25897,7 +25897,7 @@
                     "duration_days"
                   ],
                   "additionalProperties": true,
-                  "$id": "/schemas/3.1.15/core/measurement-window.json"
+                  "$id": "/schemas/3.1.20/core/measurement-window.json"
                 },
                 "minItems": 1,
                 "uniqueItems": true
@@ -25927,7 +25927,7 @@
                   "optional",
                   "none"
                 ],
-                "$id": "/schemas/3.1.15/enums/co-branding-requirement.json"
+                "$id": "/schemas/3.1.20/enums/co-branding-requirement.json"
               },
               "landing_page": {
                 "title": "Landing Page Requirement",
@@ -25938,7 +25938,7 @@
                   "retailer_site_only",
                   "must_include_retailer"
                 ],
-                "$id": "/schemas/3.1.15/enums/landing-page-requirement.json"
+                "$id": "/schemas/3.1.20/enums/landing-page-requirement.json"
               },
               "templates_available": {
                 "type": "boolean",
@@ -26007,7 +26007,7 @@
               "templates_available"
             ],
             "additionalProperties": true,
-            "$id": "/schemas/3.1.15/core/creative-policy.json"
+            "$id": "/schemas/3.1.20/core/creative-policy.json"
           },
           "is_custom": {
             "type": "boolean",
@@ -26260,7 +26260,7 @@
                       "additionalProperties": true
                     }
                   ],
-                  "$id": "/schemas/3.1.15/core/signal-id.json"
+                  "$id": "/schemas/3.1.20/core/signal-id.json"
                 },
                 "name": {
                   "type": "string",
@@ -27030,10 +27030,10 @@
                             "additionalProperties": true
                           }
                         ],
-                        "$id": "/schemas/3.1.15/core/signal-pricing.json"
+                        "$id": "/schemas/3.1.20/core/signal-pricing.json"
                       }
                     ],
-                    "$id": "/schemas/3.1.15/core/vendor-pricing-option.json"
+                    "$id": "/schemas/3.1.20/core/vendor-pricing-option.json"
                   },
                   "minItems": 1
                 }
@@ -27135,13 +27135,13 @@
                     "selection_group"
                   ],
                   "additionalProperties": true,
-                  "$id": "/schemas/3.1.15/core/signal-selection-group-rule.json"
+                  "$id": "/schemas/3.1.20/core/signal-selection-group-rule.json"
                 },
                 "minItems": 1
               }
             },
             "additionalProperties": true,
-            "$id": "/schemas/3.1.15/core/signal-targeting-rules.json"
+            "$id": "/schemas/3.1.20/core/signal-targeting-rules.json"
           },
           "signal_targeting_allowed": {
             "type": "boolean",
@@ -27795,7 +27795,7 @@
                   "good": "Meets quality thresholds for most optimization goals",
                   "excellent": "Exceeds quality thresholds across all dimensions"
                 },
-                "$id": "/schemas/3.1.15/enums/assessment-status.json"
+                "$id": "/schemas/3.1.20/enums/assessment-status.json"
               },
               "required_event_types": {
                 "type": "array",
@@ -27839,7 +27839,7 @@
                     "message"
                   ],
                   "additionalProperties": true,
-                  "$id": "/schemas/3.1.15/core/diagnostic-issue.json"
+                  "$id": "/schemas/3.1.20/core/diagnostic-issue.json"
                 }
               },
               "notes": {
@@ -27885,7 +27885,7 @@
                     "system_generated": "Event generated by an automated system",
                     "other": "Other source (specify in ext)"
                   },
-                  "$id": "/schemas/3.1.15/enums/action-source.json"
+                  "$id": "/schemas/3.1.20/enums/action-source.json"
                 },
                 "minItems": 1
               },
@@ -29195,7 +29195,7 @@
                 "collection_ids"
               ],
               "additionalProperties": true,
-              "$id": "/schemas/3.1.15/core/collection-selector.json"
+              "$id": "/schemas/3.1.20/core/collection-selector.json"
             },
             "minItems": 1
           },
@@ -29259,7 +29259,7 @@
                     "aired": "Already broadcast (live/linear content)",
                     "published": "Already released (on-demand content)"
                   },
-                  "$id": "/schemas/3.1.15/enums/installment-status.json"
+                  "$id": "/schemas/3.1.20/enums/installment-status.json"
                 },
                 "duration_seconds": {
                   "type": "integer",
@@ -29310,7 +29310,7 @@
                         "pegi": "Pan European Game Information (3, 7, 12, 16, 18) — pan-European gaming",
                         "custom": "Publisher-defined rating system with free-form values"
                       },
-                      "$id": "/schemas/3.1.15/enums/content-rating-system.json"
+                      "$id": "/schemas/3.1.20/enums/content-rating-system.json"
                     },
                     "rating": {
                       "type": "string",
@@ -29322,7 +29322,7 @@
                     "rating"
                   ],
                   "additionalProperties": true,
-                  "$id": "/schemas/3.1.15/core/content-rating.json"
+                  "$id": "/schemas/3.1.20/core/content-rating.json"
                 },
                 "topics": {
                   "type": "array",
@@ -29372,7 +29372,7 @@
                         "reunion": "Reunion or anniversary special",
                         "tribute": "Tribute or memorial special"
                       },
-                      "$id": "/schemas/3.1.15/enums/special-category.json"
+                      "$id": "/schemas/3.1.20/enums/special-category.json"
                     },
                     "starts": {
                       "type": "string",
@@ -29389,7 +29389,7 @@
                     "name"
                   ],
                   "additionalProperties": true,
-                  "$id": "/schemas/3.1.15/core/special.json"
+                  "$id": "/schemas/3.1.20/core/special.json"
                 },
                 "guest_talent": {
                   "type": "array",
@@ -29425,7 +29425,7 @@
                           "commentator": "Play-by-play or event commentator",
                           "analyst": "Color commentator or subject matter analyst"
                         },
-                        "$id": "/schemas/3.1.15/enums/talent-role.json"
+                        "$id": "/schemas/3.1.20/enums/talent-role.json"
                       },
                       "name": {
                         "type": "string",
@@ -29442,7 +29442,7 @@
                       "name"
                     ],
                     "additionalProperties": true,
-                    "$id": "/schemas/3.1.15/core/talent.json"
+                    "$id": "/schemas/3.1.20/core/talent.json"
                   }
                 },
                 "ad_inventory": {
@@ -29481,7 +29481,7 @@
                     "expected_breaks"
                   ],
                   "additionalProperties": true,
-                  "$id": "/schemas/3.1.15/core/ad-inventory-config.json"
+                  "$id": "/schemas/3.1.20/core/ad-inventory-config.json"
                 },
                 "deadlines": {
                   "title": "Installment Deadlines",
@@ -29529,14 +29529,14 @@
                           "due_at"
                         ],
                         "additionalProperties": true,
-                        "$id": "/schemas/3.1.15/core/material-deadline.json"
+                        "$id": "/schemas/3.1.20/core/material-deadline.json"
                       },
                       "minItems": 1
                     }
                   },
                   "minProperties": 1,
                   "additionalProperties": true,
-                  "$id": "/schemas/3.1.15/core/installment-deadlines.json"
+                  "$id": "/schemas/3.1.20/core/installment-deadlines.json"
                 },
                 "derivative_of": {
                   "type": "object",
@@ -29564,7 +29564,7 @@
                         "trailer": "Promotional content for the source installment",
                         "bonus": "Supplementary content (behind-the-scenes, extended interviews, deleted segments)"
                       },
-                      "$id": "/schemas/3.1.15/enums/derivative-type.json"
+                      "$id": "/schemas/3.1.20/enums/derivative-type.json"
                     }
                   },
                   "required": [
@@ -29584,7 +29584,7 @@
                 "installment_id"
               ],
               "additionalProperties": true,
-              "$id": "/schemas/3.1.15/core/installment.json"
+              "$id": "/schemas/3.1.20/core/installment.json"
             }
           },
           "enforced_policies": {
@@ -29627,7 +29627,7 @@
                     "creative": "Inline creative manifest. Offers include full rendering details.",
                     "deal": "Deal ID for programmatic execution. Offers include deal metadata."
                   },
-                  "$id": "/schemas/3.1.15/enums/response-type.json"
+                  "$id": "/schemas/3.1.20/enums/response-type.json"
                 },
                 "minItems": 1,
                 "default": [
@@ -29674,7 +29674,7 @@
                       "description": "Identity types this regional provider can resolve. The router filters providers whose uid_types includes the request's uid_type. Required when identity_match is true.",
                       "items": {
                         "title": "UID Type",
-                        "description": "Type of user identifier. Used in audience sync, event logging, and TMP identity match requests to tell the receiver which identity graph to resolve against.",
+                        "description": "Type of user identifier. Used in audience sync, event logging, and TMP identity match requests to tell the receiver how to interpret and resolve the identifier; some types, including PAIR, are publisher-scoped rather than universal identity-graph tokens.",
                         "type": "string",
                         "enum": [
                           "rampid",
@@ -29695,14 +29695,14 @@
                           "id5": "ID5 universal ID",
                           "uid2": "Unified ID 2.0",
                           "euid": "European Unified ID",
-                          "pairid": "Publisher Addressable Identity via IAB Tech Lab PAIR protocol",
+                          "pairid": "Publisher Addressable Identity via IAB Tech Lab PAIR. The OpenRTB profile uses User.eids[].source pair-protocol.com, EID.mm 3, EID.matcher set to the publisher's canonical ads.txt ownerdomain, and uids[].atype 3. The URL-safe Base64-encoded KsKp Publisher Identifier must be interpreted with that matcher scope. It is stable across a publisher's advertiser matches only within a Ks key epoch; Ks rotates every 30 days, and current and prior Publisher Identifiers can overlap during rollover. TMP identity objects do not carry matcher or ownerdomain, so a bridge requires an authenticated out-of-band binding to preserve PAIR scope.",
                           "maid": "Mobile Advertising ID (IDFA/GAID)",
                           "hashed_email": "SHA-256 hashed email address. Pseudonymous PII, not anonymous — unsalted SHA-256 of the email namespace is recoverable via precomputed dictionaries; treat as PII. See docs/reference/privacy-considerations#unsalted-hashed-identifiers-are-pseudonymous-not-anonymous.",
                           "publisher_first_party": "Publisher's own first-party identifier, opaque to buyers",
                           "world_id_nullifier": "World ID nullifier — a Sybil-resistant, relying-party-scoped, unlinkable pseudonym. Carries NO personhood or age assertion on its own; trust comes only from an accompanying verified `attestation`, never from this type tag. Distinct from the `world_id` value in the age-verification-method enum, which names a method, not an identifier.",
                           "other": "Other universal ID type (specify in ext)"
                         },
-                        "$id": "/schemas/3.1.15/enums/uid-type.json"
+                        "$id": "/schemas/3.1.20/enums/uid-type.json"
                       },
                       "minItems": 1
                     }
@@ -29958,7 +29958,7 @@
                             "saturday",
                             "sunday"
                           ],
-                          "$id": "/schemas/3.1.15/enums/day-of-week.json"
+                          "$id": "/schemas/3.1.20/enums/day-of-week.json"
                         },
                         "minItems": 1
                       },
@@ -29985,7 +29985,7 @@
                       "end_hour"
                     ],
                     "additionalProperties": false,
-                    "$id": "/schemas/3.1.15/core/daypart-target.json"
+                    "$id": "/schemas/3.1.20/core/daypart-target.json"
                   },
                   "minItems": 1
                 },
@@ -32857,7 +32857,7 @@
               "draft": "Indicative pricing and availability. The buyer can compare and plan but must finalize before purchasing. Use the 'finalize' refine action to request firm pricing and any inventory hold.",
               "committed": "Firm pricing with inventory reserved. The buyer can execute this proposal via create_media_buy before expires_at. Executing the committed proposal is buyer acceptance; finalization alone is not acceptance. After expires_at, the hold lapses and the buyer must re-finalize or re-discover."
             },
-            "$id": "/schemas/3.1.15/enums/proposal-status.json"
+            "$id": "/schemas/3.1.20/enums/proposal-status.json"
           },
           "expires_at": {
             "type": "string",
@@ -32952,7 +32952,7 @@
               "requires_signature"
             ],
             "additionalProperties": true,
-            "$id": "/schemas/3.1.15/core/insertion-order.json"
+            "$id": "/schemas/3.1.20/core/insertion-order.json"
           },
           "total_budget_guidance": {
             "type": "object",
@@ -36249,7 +36249,7 @@
         "has_more"
       ],
       "additionalProperties": false,
-      "$id": "/schemas/3.1.15/core/pagination-response.json"
+      "$id": "/schemas/3.1.20/core/pagination-response.json"
     },
     "wholesale_feed_version": {
       "type": "string",
@@ -36396,7 +36396,7 @@
         "product_placement": "Product placement, branded content, and sponsorship integrations",
         "sponsored_intelligence": "Sponsored Intelligence — advertising within AI assistants, AI search, and generative AI experiences via the reversed data flow"
       },
-      "$id": "/schemas/3.1.15/enums/channels.json"
+      "$id": "/schemas/3.1.20/enums/channels.json"
     },
     "LogoSlot": {
       "title": "Logo Slot",
@@ -36432,7 +36432,7 @@
         "co_brand_lockup": "Co-brand, partner, sponsor, or secondary-mark lockup.",
         "marketplace_listing": "Marketplace, catalog, directory, or store listing logo."
       },
-      "$id": "/schemas/3.1.15/enums/logo-slot.json"
+      "$id": "/schemas/3.1.20/enums/logo-slot.json"
     },
     "CatalogType": {
       "title": "Catalog Type",
@@ -36453,7 +36453,7 @@
         "destination",
         "app"
       ],
-      "$id": "/schemas/3.1.15/enums/catalog-type.json"
+      "$id": "/schemas/3.1.20/enums/catalog-type.json"
     },
     "VideoPlacementType": {
       "title": "Video Placement Type",
@@ -36471,7 +36471,7 @@
         "interstitial": "OpenRTB 2.6 video.plcmt=3: video ads shown as an interstitial experience, typically between content or app states.",
         "standalone": "OpenRTB 2.6 video.plcmt=4: video ads shown without associated video content, also called no-content or standalone video."
       },
-      "$id": "/schemas/3.1.15/enums/video-placement-type.json"
+      "$id": "/schemas/3.1.20/enums/video-placement-type.json"
     },
     "AudioDistributionType": {
       "title": "Audio Distribution Type",
@@ -36495,7 +36495,7 @@
         "video_game": "OpenRTB 2.6 audio.feed=6: background audio in video games.",
         "text_to_speech": "OpenRTB 2.6 audio.feed=7: text-to-speech audio such as audio books or website/plugin article narration."
       },
-      "$id": "/schemas/3.1.15/enums/audio-distribution-type.json"
+      "$id": "/schemas/3.1.20/enums/audio-distribution-type.json"
     },
     "SponsoredPlacementType": {
       "title": "Sponsored Placement Type",
@@ -36511,7 +36511,7 @@
         "sponsored_display": "Sponsored placements rendered in display slots across retailer browse, category, and product-detail pages outside the search results stream (e.g., Criteo Sponsored Display, Amazon Sponsored Display on-site).",
         "sponsored_native": "Sponsored placements rendered using the retailer's native in-grid product template, blending into the organic product listing (e.g., CitrusAd native product cards, Pinterest catalog-driven collections)."
       },
-      "$id": "/schemas/3.1.15/enums/sponsored-placement-type.json"
+      "$id": "/schemas/3.1.20/enums/sponsored-placement-type.json"
     },
     "SocialPlacementSurface": {
       "title": "Social Placement Surface",
@@ -36531,7 +36531,7 @@
         "explore": "The discovery or browse surface presenting recommended content outside the user's followed graph.",
         "search": "The in-app search-results surface, keyed to the user's query."
       },
-      "$id": "/schemas/3.1.15/enums/social-placement-surface.json"
+      "$id": "/schemas/3.1.20/enums/social-placement-surface.json"
     },
     "PriceAdjustmentKind": {
       "title": "Price Adjustment Kind",
@@ -36549,7 +36549,7 @@
         "commission": "Does not change the buyer's price or budget. Represents a revenue split — the portion retained by an intermediary (e.g., agency commission). Budgets are managed inclusive of commissions.",
         "settlement": "Does not change the committed price or budget. Applied at invoicing or payment time (e.g., cash discount for early payment). Informational for buyer agents; affects actual settlement amount."
       },
-      "$id": "/schemas/3.1.15/enums/adjustment-kind.json"
+      "$id": "/schemas/3.1.20/enums/adjustment-kind.json"
     },
     "DemographicSystem": {
       "title": "Demographic System",
@@ -36571,7 +36571,7 @@
         "mediametrie": "Mediametrie (France). Named segments + age bands",
         "custom": "Publisher-defined demographic notation"
       },
-      "$id": "/schemas/3.1.15/enums/demographic-system.json"
+      "$id": "/schemas/3.1.20/enums/demographic-system.json"
     },
     "EventType": {
       "title": "Event Type",
@@ -36643,7 +36643,7 @@
         "submit_application": "User submitted an application (loan, job, etc.)",
         "custom": "Custom event type (specify in custom_event_name)"
       },
-      "$id": "/schemas/3.1.15/enums/event-type.json"
+      "$id": "/schemas/3.1.20/enums/event-type.json"
     },
     "GeographicTargetingLevel": {
       "title": "Geographic Targeting Level",
@@ -36655,7 +36655,7 @@
         "metro",
         "postal_area"
       ],
-      "$id": "/schemas/3.1.15/enums/geo-level.json"
+      "$id": "/schemas/3.1.20/enums/geo-level.json"
     },
     "MetroAreaSystem": {
       "title": "Metro Area System",
@@ -36668,7 +36668,7 @@
         "eurostat_nuts2",
         "custom"
       ],
-      "$id": "/schemas/3.1.15/enums/metro-system.json"
+      "$id": "/schemas/3.1.20/enums/metro-system.json"
     },
     "PostalCodeSystem": {
       "title": "Postal Code System",
@@ -36699,7 +36699,7 @@
         "ch_plz",
         "at_plz"
       ],
-      "$id": "/schemas/3.1.15/enums/postal-system.json"
+      "$id": "/schemas/3.1.20/enums/postal-system.json"
     },
     "LegacyPostalCodeSystem": {
       "title": "Legacy Postal Code System",
@@ -36719,7 +36719,7 @@
         "ch_plz",
         "at_plz"
       ],
-      "$id": "/schemas/3.1.15/enums/legacy-postal-system.json"
+      "$id": "/schemas/3.1.20/enums/legacy-postal-system.json"
     },
     "DeviceType": {
       "title": "Device Type",
@@ -36733,7 +36733,7 @@
         "dooh",
         "unknown"
       ],
-      "$id": "/schemas/3.1.15/enums/device-type.json"
+      "$id": "/schemas/3.1.20/enums/device-type.json"
     },
     "DevicePlatform": {
       "title": "Device Platform",
@@ -36753,7 +36753,7 @@
         "roku_os",
         "unknown"
       ],
-      "$id": "/schemas/3.1.15/enums/device-platform.json"
+      "$id": "/schemas/3.1.20/enums/device-platform.json"
     },
     "AudienceSource": {
       "title": "Audience Source",
@@ -36767,7 +36767,7 @@
         "retargeting",
         "unknown"
       ],
-      "$id": "/schemas/3.1.15/enums/audience-source.json"
+      "$id": "/schemas/3.1.20/enums/audience-source.json"
     },
     "DigitalSourceType": {
       "title": "Digital Source Type",
@@ -36795,7 +36795,7 @@
         "human_edits": "Content augmented, corrected, or enhanced by humans using non-generative tools",
         "data_driven_media": "Assembled from structured data feeds (DCO templates, product catalogs, weather-triggered variants)"
       },
-      "$id": "/schemas/3.1.15/enums/digital-source-type.json"
+      "$id": "/schemas/3.1.20/enums/digital-source-type.json"
     },
     "EmbeddedProvenanceMethod": {
       "title": "Embedded Provenance Method",
@@ -36809,7 +36809,7 @@
         "manifest_wrapper": "A provenance manifest embedded in the file container per format-specific rules (e.g., JUMBF box in JPEG, C2PATextManifestWrapper in plaintext per C2PA Section A.7). The manifest travels with the file but is tied to the file's byte structure.",
         "provenance_markers": "Invisible markers embedded within the content stream that encode or reference a provenance record. Designed to survive reformatting, copy-paste, CMS ingestion, and ad-server transcoding that breaks file-level bindings."
       },
-      "$id": "/schemas/3.1.15/enums/embedded-provenance-method.json"
+      "$id": "/schemas/3.1.20/enums/embedded-provenance-method.json"
     },
     "WatermarkMediaType": {
       "title": "Watermark Media Type",
@@ -36827,7 +36827,7 @@
         "video": "Watermark applied to video content (e.g., per-frame image watermarking, temporal watermarking)",
         "text": "Watermark applied to text content (e.g., synonym substitution, structural modification)"
       },
-      "$id": "/schemas/3.1.15/enums/watermark-media-type.json"
+      "$id": "/schemas/3.1.20/enums/watermark-media-type.json"
     },
     "C2PAWatermarkAction": {
       "title": "C2PA Watermark Action",
@@ -36841,7 +36841,7 @@
         "c2pa.watermarked.bound": "Watermark linked to a C2PA manifest for this asset. The watermark and manifest are mutually reinforcing: the manifest references the watermark, and the watermark can be used to locate the manifest.",
         "c2pa.watermarked.unbound": "Watermark independent of any C2PA manifest. Applied before any provenance signing event (e.g., by the AI generator at creation time) or in pipelines where no manifest is present."
       },
-      "$id": "/schemas/3.1.15/enums/c2pa-watermark-action.json"
+      "$id": "/schemas/3.1.20/enums/c2pa-watermark-action.json"
     },
     "DisclosurePersistence": {
       "title": "Disclosure Persistence",
@@ -36857,7 +36857,7 @@
         "initial": "Disclosure must appear at the start of content for a minimum duration before it may be removed. Pair with min_duration_ms in render_guidance or creative brief to specify the required duration.",
         "flexible": "Disclosure presence is sufficient; placement timing and duration are at the publisher's discretion"
       },
-      "$id": "/schemas/3.1.15/enums/disclosure-persistence.json"
+      "$id": "/schemas/3.1.20/enums/disclosure-persistence.json"
     },
     "DisclosurePosition": {
       "title": "Disclosure Position",
@@ -36873,7 +36873,7 @@
         "pre_roll",
         "companion"
       ],
-      "$id": "/schemas/3.1.15/enums/disclosure-position.json"
+      "$id": "/schemas/3.1.20/enums/disclosure-position.json"
     },
     "ViewabilityStandard": {
       "title": "Viewability Standard",
@@ -36887,7 +36887,7 @@
         "mrc": "MRC/IAB standard: 50% of pixels in view for 1 continuous second (display) or 2 continuous seconds (video).",
         "groupm": "GroupM standard: 100% of pixels in view for 1 continuous second (display) or 50% of video duration."
       },
-      "$id": "/schemas/3.1.15/enums/viewability-standard.json"
+      "$id": "/schemas/3.1.20/enums/viewability-standard.json"
     },
     "ForecastRangeUnit": {
       "title": "Forecast Range Unit",
@@ -36913,7 +36913,7 @@
         "conversions": "Points at ascending conversion targets. Used in goal-based planning (e.g., Meta-style 'tell me your goal, I'll tell you the budget').",
         "package": "Each point represents a distinct inventory package (e.g., Good/Better/Best tiers, daypart packages, sponsorships). Points are not levels on a spend curve — they are separate products with different inventory compositions. Used by broadcast TV, audio, and DOOH sellers who sell packages rather than impressions at variable spend levels."
       },
-      "$id": "/schemas/3.1.15/enums/forecast-range-unit.json"
+      "$id": "/schemas/3.1.20/enums/forecast-range-unit.json"
     },
     "ForecastMethod": {
       "title": "Forecast Method",
@@ -36929,7 +36929,7 @@
         "modeled": "Forecast derived from platform-specific predictive models or historical data. Publisher uses this to set expectations but does not guarantee delivery.",
         "guaranteed": "Contractually committed delivery levels backed by reserved inventory"
       },
-      "$id": "/schemas/3.1.15/enums/forecast-method.json"
+      "$id": "/schemas/3.1.20/enums/forecast-method.json"
     },
     "ReachUnit": {
       "title": "Reach Unit",
@@ -36951,7 +36951,7 @@
         "cookies": "Unique browser cookies.",
         "custom": "Publisher-defined reach unit. Describe in ext."
       },
-      "$id": "/schemas/3.1.15/enums/reach-unit.json"
+      "$id": "/schemas/3.1.20/enums/reach-unit.json"
     },
     "ReportingFrequency": {
       "title": "Reporting Frequency",
@@ -36962,7 +36962,7 @@
         "daily",
         "monthly"
       ],
-      "$id": "/schemas/3.1.15/enums/reporting-frequency.json"
+      "$id": "/schemas/3.1.20/enums/reporting-frequency.json"
     },
     "SignalValueType": {
       "title": "Signal Value Type",
@@ -36978,7 +36978,7 @@
         "categorical": "Signal with discrete values from a defined set (e.g., 'vehicle_ownership' with values 'tesla', 'bmw', etc.)",
         "numeric": "Signal with continuous numeric values within a range (e.g., 'purchase_propensity' from 0.0 to 1.0)"
       },
-      "$id": "/schemas/3.1.15/enums/signal-value-type.json"
+      "$id": "/schemas/3.1.20/enums/signal-value-type.json"
     },
     "DataProviderSignalSelector": {
       "title": "Data Provider Signal Selector",
@@ -37071,11 +37071,11 @@
           "additionalProperties": true
         }
       ],
-      "$id": "/schemas/3.1.15/core/data-provider-signal-selector.json"
+      "$id": "/schemas/3.1.20/core/data-provider-signal-selector.json"
     }
   },
   "_bundled": {
-    "generatedAt": "2026-08-16T19:12:17.445Z",
+    "generatedAt": "2026-09-02T12:43:40.180Z",
     "note": "This is a bundled schema with all $ref resolved inline. For the modular version with references, use the parent directory."
   }
 }