@adcp/sdk 10.0.1 → 11.1.0

package/dist/lib/schemas-data/3.1/bundled/protocol/get-task-status-response.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.1/bundled/protocol/get-task-status-response.json",
+  "$id": "/schemas/3.1.2/bundled/protocol/get-task-status-response.json",
   "title": "Get Task Status Response",
   "description": "Response from the get_task_status AdCP tool, a 3.x protocol-namespace alias for legacy AdCP tasks/get. Contains AdCP application-layer task status, task metadata, and optional conversation history or terminal result payload; distinct from transport-native MCP/A2A task responses.",
   "type": "object",
@@ -28,7 +28,7 @@
           "maximum": 99
         }
       },
-      "$id": "/schemas/3.1.1/core/version-envelope.json"
+      "$id": "/schemas/3.1.2/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.1/core/context.json"
+          "$id": "/schemas/3.1.2/core/context.json"
         },
         "task_id": {
           "type": "string",
@@ -191,7 +191,7 @@
             "message"
           ],
           "additionalProperties": true,
-          "$id": "/schemas/3.1.1/core/error.json"
+          "$id": "/schemas/3.1.2/core/error.json"
         },
         "push_notification_config": {
           "title": "Push Notification Config",
@@ -464,7 +464,7 @@
         "This enum is used in task management APIs (tasks/list, tasks/get) and webhook payloads",
         "New task types require a minor version bump per semantic versioning"
       ],
-      "$id": "/schemas/3.1.1/enums/task-type.json"
+      "$id": "/schemas/3.1.2/enums/task-type.json"
     },
     "protocol": {
       "$ref": "#/$defs/AdCPProtocol"
@@ -1103,7 +1103,7 @@
                                       "mobile_ios",
                                       "instagram"
                                     ],
-                                    "$id": "/schemas/3.1.1/core/property-id.json"
+                                    "$id": "/schemas/3.1.2/core/property-id.json"
                                   },
                                   "minItems": 1
                                 }
@@ -1155,7 +1155,7 @@
                                       "meta_network",
                                       "social_media"
                                     ],
-                                    "$id": "/schemas/3.1.1/core/property-tag.json"
+                                    "$id": "/schemas/3.1.2/core/property-tag.json"
                                   },
                                   "minItems": 1
                                 }
@@ -1191,7 +1191,7 @@
                               "additionalProperties": true
                             }
                           ],
-                          "$id": "/schemas/3.1.1/core/publisher-property-selector.json"
+                          "$id": "/schemas/3.1.2/core/publisher-property-selector.json"
                         },
                         {
                           "not": {
@@ -1260,7 +1260,7 @@
                           "width"
                         ]
                       },
-                      "$id": "/schemas/3.1.1/core/format-id.json"
+                      "$id": "/schemas/3.1.2/core/format-id.json"
                     }
                   },
                   "format_options": {
@@ -1402,7 +1402,7 @@
                               "digest": "sha256:a3f5b7c9d8e2f1a4b6c8d0e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d6e8f0a2"
                             }
                           ],
-                          "$id": "/schemas/3.1.1/core/platform-extension-ref.json"
+                          "$id": "/schemas/3.1.2/core/platform-extension-ref.json"
                         }
                       },
                       "allOf": [
@@ -1976,7 +1976,7 @@
                                             "authorization_instructions": "Connect the creator or page that owns the source post."
                                           }
                                         ],
-                                        "$id": "/schemas/3.1.1/core/downstream-connection-requirement.json"
+                                        "$id": "/schemas/3.1.2/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."
                                     },
@@ -18931,7 +18931,7 @@
                                 }
                               },
                               "additionalProperties": true,
-                              "$id": "/schemas/3.1.1/pricing-options/price-guidance.json"
+                              "$id": "/schemas/3.1.2/pricing-options/price-guidance.json"
                             },
                             "min_spend_per_package": {
                               "type": "number",
@@ -20945,7 +20945,7 @@
                                           "placement_id"
                                         ],
                                         "additionalProperties": true,
-                                        "$id": "/schemas/3.1.1/core/placement-ref.json"
+                                        "$id": "/schemas/3.1.2/core/placement-ref.json"
                                       },
                                       "placement_name": {
                                         "type": "string",
@@ -20957,7 +20957,7 @@
                                       "placement_ref"
                                     ],
                                     "additionalProperties": false,
-                                    "$id": "/schemas/3.1.1/core/forecast-dimension-placement.json"
+                                    "$id": "/schemas/3.1.2/core/forecast-dimension-placement.json"
                                   },
                                   {
                                     "title": "Device Type Forecast Dimension",
@@ -21200,7 +21200,7 @@
                                             "additionalProperties": true
                                           }
                                         ],
-                                        "$id": "/schemas/3.1.1/core/signal-ref.json"
+                                        "$id": "/schemas/3.1.2/core/signal-ref.json"
                                       },
                                       "signal_id": {
                                         "type": "string",
@@ -21298,7 +21298,7 @@
                                       }
                                     ],
                                     "additionalProperties": false,
-                                    "$id": "/schemas/3.1.1/core/forecast-dimension-signal.json"
+                                    "$id": "/schemas/3.1.2/core/forecast-dimension-signal.json"
                                   }
                                 ]
                               }
@@ -21342,7 +21342,7 @@
                                     }
                                   ],
                                   "additionalProperties": true,
-                                  "$id": "/schemas/3.1.1/core/forecast-range.json"
+                                  "$id": "/schemas/3.1.2/core/forecast-range.json"
                                 },
                                 "reach": {
                                   "title": "Forecast Range",
@@ -22003,7 +22003,7 @@
                                         "nike",
                                         "pampers"
                                       ],
-                                      "$id": "/schemas/3.1.1/core/brand-id.json"
+                                      "$id": "/schemas/3.1.2/core/brand-id.json"
                                     },
                                     "industries": {
                                       "type": "array",
@@ -22348,7 +22348,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.1/core/ext.json"
+                                                                "$id": "/schemas/3.1.2/core/ext.json"
                                                               }
                                                             },
                                                             "additionalProperties": true
@@ -23202,7 +23202,7 @@
                                       "co_view_index",
                                       "incremental_lift_percent"
                                     ],
-                                    "$id": "/schemas/3.1.1/core/vendor-metric-id.json"
+                                    "$id": "/schemas/3.1.2/core/vendor-metric-id.json"
                                   },
                                   "value": {
                                     "title": "Forecast Range",
@@ -23449,7 +23449,7 @@
                               "unit"
                             ],
                             "additionalProperties": false,
-                            "$id": "/schemas/3.1.1/core/duration.json"
+                            "$id": "/schemas/3.1.2/core/duration.json"
                           }
                         ],
                         "description": "Attribution window as a structured duration (e.g., {\"interval\": 30, \"unit\": \"days\"})."
@@ -23469,7 +23469,7 @@
                       "reporting"
                     ],
                     "additionalProperties": true,
-                    "$id": "/schemas/3.1.1/core/outcome-measurement.json"
+                    "$id": "/schemas/3.1.2/core/outcome-measurement.json"
                   },
                   "delivery_measurement": {
                     "type": "object",
@@ -25146,7 +25146,7 @@
                       "cancellation_fee"
                     ],
                     "additionalProperties": true,
-                    "$id": "/schemas/3.1.1/core/cancellation-policy.json"
+                    "$id": "/schemas/3.1.2/core/cancellation-policy.json"
                   },
                   "allowed_actions": {
                     "type": "array",
@@ -25204,7 +25204,7 @@
                             }
                           },
                           "additionalProperties": false,
-                          "$id": "/schemas/3.1.1/core/sla-window.json"
+                          "$id": "/schemas/3.1.2/core/sla-window.json"
                         },
                         "terms_ref": {
                           "type": "string",
@@ -26111,7 +26111,7 @@
                             "duration_days"
                           ],
                           "additionalProperties": true,
-                          "$id": "/schemas/3.1.1/core/measurement-window.json"
+                          "$id": "/schemas/3.1.2/core/measurement-window.json"
                         },
                         "minItems": 1,
                         "uniqueItems": true
@@ -26457,7 +26457,7 @@
                               "additionalProperties": true
                             }
                           ],
-                          "$id": "/schemas/3.1.1/core/signal-id.json"
+                          "$id": "/schemas/3.1.2/core/signal-id.json"
                         },
                         "name": {
                           "type": "string",
@@ -27227,10 +27227,10 @@
                                     "additionalProperties": true
                                   }
                                 ],
-                                "$id": "/schemas/3.1.1/core/signal-pricing.json"
+                                "$id": "/schemas/3.1.2/core/signal-pricing.json"
                               }
                             ],
-                            "$id": "/schemas/3.1.1/core/vendor-pricing-option.json"
+                            "$id": "/schemas/3.1.2/core/vendor-pricing-option.json"
                           },
                           "minItems": 1
                         }
@@ -27332,13 +27332,13 @@
                             "selection_group"
                           ],
                           "additionalProperties": true,
-                          "$id": "/schemas/3.1.1/core/signal-selection-group-rule.json"
+                          "$id": "/schemas/3.1.2/core/signal-selection-group-rule.json"
                         },
                         "minItems": 1
                       }
                     },
                     "additionalProperties": true,
-                    "$id": "/schemas/3.1.1/core/signal-targeting-rules.json"
+                    "$id": "/schemas/3.1.2/core/signal-targeting-rules.json"
                   },
                   "signal_targeting_allowed": {
                     "type": "boolean",
@@ -28021,7 +28021,7 @@
                             "message"
                           ],
                           "additionalProperties": true,
-                          "$id": "/schemas/3.1.1/core/diagnostic-issue.json"
+                          "$id": "/schemas/3.1.2/core/diagnostic-issue.json"
                         }
                       },
                       "notes": {
@@ -29352,7 +29352,7 @@
                         "collection_ids"
                       ],
                       "additionalProperties": true,
-                      "$id": "/schemas/3.1.1/core/collection-selector.json"
+                      "$id": "/schemas/3.1.2/core/collection-selector.json"
                     },
                     "minItems": 1
                   },
@@ -29529,7 +29529,7 @@
                             "expected_breaks"
                           ],
                           "additionalProperties": true,
-                          "$id": "/schemas/3.1.1/core/ad-inventory-config.json"
+                          "$id": "/schemas/3.1.2/core/ad-inventory-config.json"
                         },
                         "deadlines": {
                           "title": "Installment Deadlines",
@@ -29577,14 +29577,14 @@
                                   "due_at"
                                 ],
                                 "additionalProperties": true,
-                                "$id": "/schemas/3.1.1/core/material-deadline.json"
+                                "$id": "/schemas/3.1.2/core/material-deadline.json"
                               },
                               "minItems": 1
                             }
                           },
                           "minProperties": 1,
                           "additionalProperties": true,
-                          "$id": "/schemas/3.1.1/core/installment-deadlines.json"
+                          "$id": "/schemas/3.1.2/core/installment-deadlines.json"
                         },
                         "derivative_of": {
                           "type": "object",
@@ -32830,7 +32830,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.1/enums/proposal-status.json"
+                    "$id": "/schemas/3.1.2/enums/proposal-status.json"
                   },
                   "expires_at": {
                     "type": "string",
@@ -32925,7 +32925,7 @@
                       "requires_signature"
                     ],
                     "additionalProperties": true,
-                    "$id": "/schemas/3.1.1/core/insertion-order.json"
+                    "$id": "/schemas/3.1.2/core/insertion-order.json"
                   },
                   "total_budget_guidance": {
                     "type": "object",
@@ -36222,7 +36222,7 @@
                 "has_more"
               ],
               "additionalProperties": false,
-              "$id": "/schemas/3.1.1/core/pagination-response.json"
+              "$id": "/schemas/3.1.2/core/pagination-response.json"
             },
             "wholesale_feed_version": {
               "type": "string",
@@ -36358,7 +36358,7 @@
             }
           },
           "additionalProperties": true,
-          "$id": "/schemas/3.1.1/media-buy/get-products-async-response-working.json"
+          "$id": "/schemas/3.1.2/media-buy/get-products-async-response-working.json"
         },
         {
           "title": "Get Products - Input Required",
@@ -65385,7 +65385,7 @@
               }
             ]
           },
-          "$id": "/schemas/3.1.1/media-buy/get-products-async-response-submitted.json"
+          "$id": "/schemas/3.1.2/media-buy/get-products-async-response-submitted.json"
         },
         {
           "title": "Get Signals Response",
@@ -66147,7 +66147,7 @@
                             "age": "A person's age or age range. US ADEA (40+) for employment, US FHA for housing, EU AVMSD for content-directed targeting. Restricted for regulated verticals.",
                             "familial_status": "Whether a household includes children under 18, a pregnant person, or a person seeking custody of a minor. US FHA protected class."
                           },
-                          "$id": "/schemas/3.1.1/enums/restricted-attribute.json"
+                          "$id": "/schemas/3.1.2/enums/restricted-attribute.json"
                         },
                         "minItems": 1
                       },
@@ -66387,7 +66387,7 @@
                             "contract",
                             "legal_obligation"
                           ],
-                          "$id": "/schemas/3.1.1/enums/consent-basis.json"
+                          "$id": "/schemas/3.1.2/enums/consent-basis.json"
                         },
                         "description": "Data provider's declared GDPR Article 6 lawful basis or consent basis for the underlying signal definition, projected into this get_signals response row when requested. Sellers and federating agents that pass through another provider's signal MUST NOT substitute their own processing basis for the provider-declared basis."
                       },
@@ -66538,7 +66538,7 @@
                               }
                             ],
                             "additionalProperties": false,
-                            "$id": "/schemas/3.1.1/core/signal-modeling-disclosure.json"
+                            "$id": "/schemas/3.1.2/core/signal-modeling-disclosure.json"
                           }
                         },
                         "required": [
@@ -66664,7 +66664,7 @@
                       }
                     },
                     "additionalProperties": true,
-                    "$id": "/schemas/3.1.1/core/signal-definition-enrichment.json"
+                    "$id": "/schemas/3.1.2/core/signal-definition-enrichment.json"
                   }
                 ],
                 "properties": {
@@ -66951,7 +66951,7 @@
                       "custom": "Source-native segment built on demand from models, composites, or buyer inputs - not attributable to a standing upstream provider",
                       "owned": "First-party segments derived from data the signal agent or seller directly owns (retailer purchase data, publisher behavioral data, telco data)"
                     },
-                    "$id": "/schemas/3.1.1/enums/signal-catalog-type.json"
+                    "$id": "/schemas/3.1.2/enums/signal-catalog-type.json"
                   },
                   "data_provider": {
                     "type": "string",
@@ -69844,7 +69844,7 @@
                               "end"
                             ],
                             "additionalProperties": true,
-                            "$id": "/schemas/3.1.1/core/date-range.json"
+                            "$id": "/schemas/3.1.2/core/date-range.json"
                           }
                         },
                         "required": [
@@ -70007,7 +70007,7 @@
                                   "additionalProperties": true
                                 }
                               ],
-                              "$id": "/schemas/3.1.1/core/activation-key.json"
+                              "$id": "/schemas/3.1.2/core/activation-key.json"
                             },
                             "estimated_activation_duration_minutes": {
                               "type": "number",
@@ -70118,7 +70118,7 @@
                           "additionalProperties": true
                         }
                       ],
-                      "$id": "/schemas/3.1.1/core/deployment.json"
+                      "$id": "/schemas/3.1.2/core/deployment.json"
                     }
                   },
                   "pricing_options": {
@@ -70776,7 +70776,7 @@
             }
           },
           "additionalProperties": true,
-          "$id": "/schemas/3.1.1/signals/get-signals-async-response-working.json"
+          "$id": "/schemas/3.1.2/signals/get-signals-async-response-working.json"
         },
         {
           "title": "Get Signals - Submitted",
@@ -70963,7 +70963,7 @@
               }
             ]
           },
-          "$id": "/schemas/3.1.1/signals/get-signals-async-response-submitted.json"
+          "$id": "/schemas/3.1.2/signals/get-signals-async-response-submitted.json"
         },
         {
           "title": "Create Media Buy Response",
@@ -72108,7 +72108,7 @@
                           }
                         }
                       ],
-                      "$id": "/schemas/3.1.1/core/business-entity.json"
+                      "$id": "/schemas/3.1.2/core/business-entity.json"
                     },
                     "rate_card": {
                       "type": "string",
@@ -73197,7 +73197,7 @@
                                     }
                                   }
                                 ],
-                                "$id": "/schemas/3.1.1/core/catalog-field-mapping.json"
+                                "$id": "/schemas/3.1.2/core/catalog-field-mapping.json"
                               },
                               "minItems": 1
                             }
@@ -73441,7 +73441,7 @@
                             }
                           ],
                           "additionalProperties": true,
-                          "$id": "/schemas/3.1.1/core/format-option-ref.json"
+                          "$id": "/schemas/3.1.2/core/format-option-ref.json"
                         },
                         "minItems": 1
                       },
@@ -74657,7 +74657,7 @@
                                                 "additionalProperties": true
                                               }
                                             ],
-                                            "$id": "/schemas/3.1.1/core/signal-targeting-expression.json"
+                                            "$id": "/schemas/3.1.2/core/signal-targeting-expression.json"
                                           }
                                         ],
                                         "properties": {
@@ -74724,7 +74724,7 @@
                                           }
                                         },
                                         "additionalProperties": true,
-                                        "$id": "/schemas/3.1.1/core/package-signal-targeting.json"
+                                        "$id": "/schemas/3.1.2/core/package-signal-targeting.json"
                                       },
                                       "minItems": 1
                                     }
@@ -74734,7 +74734,7 @@
                                     "signals"
                                   ],
                                   "additionalProperties": true,
-                                  "$id": "/schemas/3.1.1/core/package-signal-targeting-group.json"
+                                  "$id": "/schemas/3.1.2/core/package-signal-targeting-group.json"
                                 },
                                 "minItems": 1
                               }
@@ -74744,7 +74744,7 @@
                               "groups"
                             ],
                             "additionalProperties": true,
-                            "$id": "/schemas/3.1.1/core/package-signal-targeting-groups.json"
+                            "$id": "/schemas/3.1.2/core/package-signal-targeting-groups.json"
                           },
                           "signal_targeting": {
                             "type": "array",
@@ -75542,7 +75542,7 @@
                                   "additionalProperties": true
                                 }
                               ],
-                              "$id": "/schemas/3.1.1/core/signal-targeting.json"
+                              "$id": "/schemas/3.1.2/core/signal-targeting.json"
                             },
                             "minItems": 1
                           },
@@ -75693,7 +75693,7 @@
                               "list_id"
                             ],
                             "additionalProperties": false,
-                            "$id": "/schemas/3.1.1/core/property-list-ref.json"
+                            "$id": "/schemas/3.1.2/core/property-list-ref.json"
                           },
                           "collection_list": {
                             "title": "Collection List Reference",
@@ -75721,7 +75721,7 @@
                               "list_id"
                             ],
                             "additionalProperties": false,
-                            "$id": "/schemas/3.1.1/core/collection-list-ref.json"
+                            "$id": "/schemas/3.1.2/core/collection-list-ref.json"
                           },
                           "collection_list_exclude": {
                             "title": "Collection List Reference",
@@ -77862,7 +77862,7 @@
                             "creative_id"
                           ],
                           "additionalProperties": true,
-                          "$id": "/schemas/3.1.1/core/creative-assignment.json"
+                          "$id": "/schemas/3.1.2/core/creative-assignment.json"
                         }
                       },
                       "format_ids_to_provide": {
@@ -79965,7 +79965,7 @@
                             "additionalProperties": true
                           }
                         ],
-                        "$id": "/schemas/3.1.1/core/audience-selector.json"
+                        "$id": "/schemas/3.1.2/core/audience-selector.json"
                       },
                       "minItems": 1
                     },
@@ -80480,7 +80480,7 @@
             }
           },
           "additionalProperties": true,
-          "$id": "/schemas/3.1.1/media-buy/create-media-buy-async-response-working.json"
+          "$id": "/schemas/3.1.2/media-buy/create-media-buy-async-response-working.json"
         },
         {
           "title": "Create Media Buy - Input Required",
@@ -80637,7 +80637,7 @@
             }
           },
           "additionalProperties": true,
-          "$id": "/schemas/3.1.1/media-buy/create-media-buy-async-response-input-required.json"
+          "$id": "/schemas/3.1.2/media-buy/create-media-buy-async-response-input-required.json"
         },
         {
           "title": "Create Media Buy - Submitted",
@@ -80805,7 +80805,7 @@
             "task_id"
           ],
           "additionalProperties": true,
-          "$id": "/schemas/3.1.1/media-buy/create-media-buy-async-response-submitted.json"
+          "$id": "/schemas/3.1.2/media-buy/create-media-buy-async-response-submitted.json"
         },
         {
           "title": "Update Media Buy Response",
@@ -88045,7 +88045,7 @@
             }
           },
           "additionalProperties": true,
-          "$id": "/schemas/3.1.1/media-buy/update-media-buy-async-response-working.json"
+          "$id": "/schemas/3.1.2/media-buy/update-media-buy-async-response-working.json"
         },
         {
           "title": "Update Media Buy - Input Required",
@@ -88074,7 +88074,7 @@
             }
           },
           "additionalProperties": true,
-          "$id": "/schemas/3.1.1/media-buy/update-media-buy-async-response-input-required.json"
+          "$id": "/schemas/3.1.2/media-buy/update-media-buy-async-response-input-required.json"
         },
         {
           "title": "Update Media Buy - Submitted",
@@ -88242,7 +88242,7 @@
             "task_id"
           ],
           "additionalProperties": true,
-          "$id": "/schemas/3.1.1/media-buy/update-media-buy-async-response-submitted.json"
+          "$id": "/schemas/3.1.2/media-buy/update-media-buy-async-response-submitted.json"
         },
         {
           "title": "Media Buy Delivery Webhook Result",
@@ -88467,8 +88467,11 @@
                             "minimum": 0
                           },
                           "completion_rate": {
-                            "type": "number",
-                            "description": "Completion rate (completed_views/impressions)",
+                            "type": [
+                              "number",
+                              "null"
+                            ],
+                            "description": "Completion rate (completed_views/impressions). Null indicates the metric is not applicable to this package/buy (e.g. completion rate on a non-video buy).",
                             "minimum": 0,
                             "maximum": 1
                           },
@@ -88662,8 +88665,11 @@
                             "minimum": 0
                           },
                           "quartile_data": {
-                            "type": "object",
-                            "description": "Audio/video quartile completion data",
+                            "type": [
+                              "object",
+                              "null"
+                            ],
+                            "description": "Audio/video quartile completion data. Null indicates the metric is not applicable to this package/buy (e.g. quartile data on a non-video buy).",
                             "properties": {
                               "q1_views": {
                                 "type": "number",
@@ -90035,8 +90041,11 @@
                               "minimum": 0
                             },
                             "completion_rate": {
-                              "type": "number",
-                              "description": "Completion rate (completed_views/impressions)",
+                              "type": [
+                                "number",
+                                "null"
+                              ],
+                              "description": "Completion rate (completed_views/impressions). Null indicates the metric is not applicable to this package/buy (e.g. completion rate on a non-video buy).",
                               "minimum": 0,
                               "maximum": 1
                             },
@@ -90230,8 +90239,11 @@
                               "minimum": 0
                             },
                             "quartile_data": {
-                              "type": "object",
-                              "description": "Audio/video quartile completion data",
+                              "type": [
+                                "object",
+                                "null"
+                              ],
+                              "description": "Audio/video quartile completion data. Null indicates the metric is not applicable to this package/buy (e.g. quartile data on a non-video buy).",
                               "properties": {
                                 "q1_views": {
                                   "type": "number",
@@ -97290,7 +97302,7 @@
                                               "role"
                                             ],
                                             "additionalProperties": true,
-                                            "$id": "/schemas/3.1.1/core/reference-asset.json"
+                                            "$id": "/schemas/3.1.2/core/reference-asset.json"
                                           }
                                         },
                                         "compliance": {
@@ -111267,7 +111279,7 @@
                                   "additionalProperties": true
                                 }
                               ],
-                              "$id": "/schemas/3.1.1/creative/preview-render.json"
+                              "$id": "/schemas/3.1.2/creative/preview-render.json"
                             },
                             "minItems": 1
                           },
@@ -111487,7 +111499,7 @@
                     }
                   },
                   "additionalProperties": true,
-                  "$id": "/schemas/3.1.1/core/creative-consumption.json"
+                  "$id": "/schemas/3.1.2/core/creative-consumption.json"
                 },
                 "context": {
                   "title": "Context Object",
@@ -150671,7 +150683,7 @@
                                       "value"
                                     ],
                                     "additionalProperties": false,
-                                    "$id": "/schemas/3.1.1/creative/creative-feature-result.json"
+                                    "$id": "/schemas/3.1.2/creative/creative-feature-result.json"
                                   }
                                 },
                                 "ranked_against": {
@@ -150968,7 +150980,7 @@
                     "inventory_priority": "Rank by seller-side catalog metadata (margin, overstock, promotional priority). No buyer input.",
                     "random": "Status-quo fallback: agent samples without a ranking preference. Default when selection_strategy is omitted."
                   },
-                  "$id": "/schemas/3.1.1/enums/creative-selection-strategy.json"
+                  "$id": "/schemas/3.1.2/enums/creative-selection-strategy.json"
                 },
                 "budget_status": {
                   "type": "string",
@@ -151738,7 +151750,7 @@
             }
           },
           "additionalProperties": true,
-          "$id": "/schemas/3.1.1/media-buy/build-creative-async-response-working.json"
+          "$id": "/schemas/3.1.2/media-buy/build-creative-async-response-working.json"
         },
         {
           "title": "Build Creative - Input Required",
@@ -151896,7 +151908,7 @@
             }
           },
           "additionalProperties": true,
-          "$id": "/schemas/3.1.1/media-buy/build-creative-async-response-input-required.json"
+          "$id": "/schemas/3.1.2/media-buy/build-creative-async-response-input-required.json"
         },
         {
           "title": "Build Creative - Submitted",
@@ -152064,7 +152076,7 @@
             "task_id"
           ],
           "additionalProperties": true,
-          "$id": "/schemas/3.1.1/media-buy/build-creative-async-response-submitted.json"
+          "$id": "/schemas/3.1.2/media-buy/build-creative-async-response-submitted.json"
         },
         {
           "title": "Sync Creatives Response",
@@ -153656,7 +153668,7 @@
                           "failed",
                           "deleted"
                         ],
-                        "$id": "/schemas/3.1.1/enums/creative-action.json"
+                        "$id": "/schemas/3.1.2/enums/creative-action.json"
                       },
                       "status": {
                         "title": "Creative Status",
@@ -153678,7 +153690,7 @@
                           "rejected": "Creative was rejected due to content policy, technical issues, or terminal dependency/authorization loss. Reached from 'pending_review' (initial review failure), from 'approved' (post-approval revocation by the seller — policy change, takedown request, content drift), or from 'suspended' when a previously recoverable dependency is determined unrecoverable for this creative. Not terminal — the buyer may fix the issue and resubmit via sync_creatives, which returns the creative to processing.",
                           "archived": "Creative has been archived and is excluded from default queries. Archive MAY be buyer-initiated (explicit cleanup) or seller-initiated (inactivity, post-flight expiry, storage policy, account suspension) — seller-initiated archive is only valid when no active package assignments reference the creative. Archived creatives retain their data and may be unarchived back to approved by the buyer. Buyer-initiated archive is acknowledged on the `sync_creatives` response path. Seller-initiated archive (`approved → archived`) fires `creative.status_changed` against the account's `notification_configs[]` subscribers (see `notification-type.json` and `sync_accounts`); buyers MUST observe the new status on the next `list_creatives` read regardless of whether the webhook was delivered. Destruction is a distinct event (`creative.purged`); purged creatives do not appear in default `list_creatives` results and MAY surface as tombstones when `include_purged: true` is supplied — see `list_creatives` for the tombstone shape."
                         },
-                        "$id": "/schemas/3.1.1/enums/creative-status.json"
+                        "$id": "/schemas/3.1.2/enums/creative-status.json"
                       },
                       "platform_id": {
                         "type": "string",
@@ -154342,7 +154354,7 @@
             }
           },
           "additionalProperties": true,
-          "$id": "/schemas/3.1.1/creative/sync-creatives-async-response-working.json"
+          "$id": "/schemas/3.1.2/creative/sync-creatives-async-response-working.json"
         },
         {
           "title": "Sync Creatives - Input Required",
@@ -154372,7 +154384,7 @@
             }
           },
           "additionalProperties": true,
-          "$id": "/schemas/3.1.1/creative/sync-creatives-async-response-input-required.json"
+          "$id": "/schemas/3.1.2/creative/sync-creatives-async-response-input-required.json"
         },
         {
           "title": "Sync Creatives - Submitted",
@@ -154540,7 +154552,7 @@
             "task_id"
           ],
           "additionalProperties": true,
-          "$id": "/schemas/3.1.1/creative/sync-creatives-async-response-submitted.json"
+          "$id": "/schemas/3.1.2/creative/sync-creatives-async-response-submitted.json"
         },
         {
           "title": "Sync Catalogs Response",
@@ -154967,7 +154979,7 @@
                           "failed",
                           "deleted"
                         ],
-                        "$id": "/schemas/3.1.1/enums/catalog-action.json"
+                        "$id": "/schemas/3.1.2/enums/catalog-action.json"
                       },
                       "platform_id": {
                         "type": "string",
@@ -155021,7 +155033,7 @@
                                 "warning": "Item is approved and serving but has issues worth fixing (e.g., low-quality image, missing optional fields). The item remains eligible for delivery.",
                                 "withdrawn": "Seller has removed the item from active use — inventory pulled, policy enforcement, or other seller-initiated reasons not covered by 'rejected'. Distinct lifecycle from 'rejected': no buyer-side resubmit path. Sellers MUST surface a corresponding impairment on any active media buy that targets a package referencing this catalog item. Sellers MAY return the item to 'approved' on re-publication."
                               },
-                              "$id": "/schemas/3.1.1/enums/catalog-item-status.json"
+                              "$id": "/schemas/3.1.2/enums/catalog-item-status.json"
                             },
                             "reasons": {
                               "type": "array",
@@ -155663,7 +155675,7 @@
             }
           },
           "additionalProperties": true,
-          "$id": "/schemas/3.1.1/media-buy/sync-catalogs-async-response-working.json"
+          "$id": "/schemas/3.1.2/media-buy/sync-catalogs-async-response-working.json"
         },
         {
           "title": "Sync Catalogs - Input Required",
@@ -155694,7 +155706,7 @@
             }
           },
           "additionalProperties": true,
-          "$id": "/schemas/3.1.1/media-buy/sync-catalogs-async-response-input-required.json"
+          "$id": "/schemas/3.1.2/media-buy/sync-catalogs-async-response-input-required.json"
         },
         {
           "title": "Sync Catalogs - Submitted",
@@ -155862,7 +155874,7 @@
             "task_id"
           ],
           "additionalProperties": true,
-          "$id": "/schemas/3.1.1/media-buy/sync-catalogs-async-response-submitted.json"
+          "$id": "/schemas/3.1.2/media-buy/sync-catalogs-async-response-submitted.json"
         }
       ]
     },
@@ -155915,7 +155927,7 @@
         "auth-required": "Task requires authentication to proceed",
         "unknown": "Task is in an unknown or indeterminate state"
       },
-      "$id": "/schemas/3.1.1/enums/task-status.json"
+      "$id": "/schemas/3.1.2/enums/task-status.json"
     },
     "AuthenticationScheme": {
       "title": "Authentication Scheme",
@@ -155925,7 +155937,7 @@
         "Bearer",
         "HMAC-SHA256"
       ],
-      "$id": "/schemas/3.1.1/enums/auth-scheme.json"
+      "$id": "/schemas/3.1.2/enums/auth-scheme.json"
     },
     "AdCPProtocol": {
       "title": "AdCP Protocol",
@@ -155949,7 +155961,7 @@
         "sponsored-intelligence": "AI-mediated commerce and conversational sponsored experiences, including buyer-agent sessions and measurement of AI-surfaced outcomes",
         "measurement": "Experimental in 3.1. Measurement vendor capability discovery and per-metric reporting. Currently scoped to `get_adcp_capabilities` for catalog discovery (the `measurement` capability block); agents implementing it must list `measurement.core` in experimental_features. Additional measurement tasks (reporting, attribution, panel queries) land in subsequent minors."
       },
-      "$id": "/schemas/3.1.1/enums/adcp-protocol.json"
+      "$id": "/schemas/3.1.2/enums/adcp-protocol.json"
     },
     "MediaChannel": {
       "title": "Media Channel",
@@ -155999,7 +156011,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.1/enums/channels.json"
+      "$id": "/schemas/3.1.2/enums/channels.json"
     },
     "LogoSlot": {
       "title": "Logo Slot",
@@ -156035,7 +156047,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.1/enums/logo-slot.json"
+      "$id": "/schemas/3.1.2/enums/logo-slot.json"
     },
     "VideoPlacementType": {
       "title": "Video Placement Type",
@@ -156053,7 +156065,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.1/enums/video-placement-type.json"
+      "$id": "/schemas/3.1.2/enums/video-placement-type.json"
     },
     "AudioDistributionType": {
       "title": "Audio Distribution Type",
@@ -156077,7 +156089,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.1/enums/audio-distribution-type.json"
+      "$id": "/schemas/3.1.2/enums/audio-distribution-type.json"
     },
     "SponsoredPlacementType": {
       "title": "Sponsored Placement Type",
@@ -156093,7 +156105,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.1/enums/sponsored-placement-type.json"
+      "$id": "/schemas/3.1.2/enums/sponsored-placement-type.json"
     },
     "SocialPlacementSurface": {
       "title": "Social Placement Surface",
@@ -156113,7 +156125,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.1/enums/social-placement-surface.json"
+      "$id": "/schemas/3.1.2/enums/social-placement-surface.json"
     },
     "DeliveryType": {
       "title": "Delivery Type",
@@ -156127,7 +156139,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.1/enums/delivery-type.json"
+      "$id": "/schemas/3.1.2/enums/delivery-type.json"
     },
     "Exclusivity": {
       "title": "Exclusivity",
@@ -156143,7 +156155,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.1/enums/exclusivity.json"
+      "$id": "/schemas/3.1.2/enums/exclusivity.json"
     },
     "PriceAdjustmentKind": {
       "title": "Price Adjustment Kind",
@@ -156161,7 +156173,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.1/enums/adjustment-kind.json"
+      "$id": "/schemas/3.1.2/enums/adjustment-kind.json"
     },
     "DemographicSystem": {
       "title": "Demographic System",
@@ -156183,7 +156195,7 @@
         "mediametrie": "Mediametrie (France). Named segments + age bands",
         "custom": "Publisher-defined demographic notation"
       },
-      "$id": "/schemas/3.1.1/enums/demographic-system.json"
+      "$id": "/schemas/3.1.2/enums/demographic-system.json"
     },
     "EventType": {
       "title": "Event Type",
@@ -156255,7 +156267,7 @@
         "submit_application": "User submitted an application (loan, job, etc.)",
         "custom": "Custom event type (specify in custom_event_name)"
       },
-      "$id": "/schemas/3.1.1/enums/event-type.json"
+      "$id": "/schemas/3.1.2/enums/event-type.json"
     },
     "GeographicTargetingLevel": {
       "title": "Geographic Targeting Level",
@@ -156267,7 +156279,7 @@
         "metro",
         "postal_area"
       ],
-      "$id": "/schemas/3.1.1/enums/geo-level.json"
+      "$id": "/schemas/3.1.2/enums/geo-level.json"
     },
     "MetroAreaSystem": {
       "title": "Metro Area System",
@@ -156280,7 +156292,7 @@
         "eurostat_nuts2",
         "custom"
       ],
-      "$id": "/schemas/3.1.1/enums/metro-system.json"
+      "$id": "/schemas/3.1.2/enums/metro-system.json"
     },
     "PostalCodeSystem": {
       "title": "Postal Code System",
@@ -156311,7 +156323,7 @@
         "ch_plz",
         "at_plz"
       ],
-      "$id": "/schemas/3.1.1/enums/postal-system.json"
+      "$id": "/schemas/3.1.2/enums/postal-system.json"
     },
     "LegacyPostalCodeSystem": {
       "title": "Legacy Postal Code System",
@@ -156331,7 +156343,7 @@
         "ch_plz",
         "at_plz"
       ],
-      "$id": "/schemas/3.1.1/enums/legacy-postal-system.json"
+      "$id": "/schemas/3.1.2/enums/legacy-postal-system.json"
     },
     "DeviceType": {
       "title": "Device Type",
@@ -156345,7 +156357,7 @@
         "dooh",
         "unknown"
       ],
-      "$id": "/schemas/3.1.1/enums/device-type.json"
+      "$id": "/schemas/3.1.2/enums/device-type.json"
     },
     "DevicePlatform": {
       "title": "Device Platform",
@@ -156365,7 +156377,7 @@
         "roku_os",
         "unknown"
       ],
-      "$id": "/schemas/3.1.1/enums/device-platform.json"
+      "$id": "/schemas/3.1.2/enums/device-platform.json"
     },
     "AudienceSource": {
       "title": "Audience Source",
@@ -156379,7 +156391,7 @@
         "retargeting",
         "unknown"
       ],
-      "$id": "/schemas/3.1.1/enums/audience-source.json"
+      "$id": "/schemas/3.1.2/enums/audience-source.json"
     },
     "DigitalSourceType": {
       "title": "Digital Source Type",
@@ -156407,7 +156419,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.1/enums/digital-source-type.json"
+      "$id": "/schemas/3.1.2/enums/digital-source-type.json"
     },
     "EmbeddedProvenanceMethod": {
       "title": "Embedded Provenance Method",
@@ -156421,7 +156433,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.1/enums/embedded-provenance-method.json"
+      "$id": "/schemas/3.1.2/enums/embedded-provenance-method.json"
     },
     "WatermarkMediaType": {
       "title": "Watermark Media Type",
@@ -156439,7 +156451,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.1/enums/watermark-media-type.json"
+      "$id": "/schemas/3.1.2/enums/watermark-media-type.json"
     },
     "C2PAWatermarkAction": {
       "title": "C2PA Watermark Action",
@@ -156453,7 +156465,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.1/enums/c2pa-watermark-action.json"
+      "$id": "/schemas/3.1.2/enums/c2pa-watermark-action.json"
     },
     "DisclosurePersistence": {
       "title": "Disclosure Persistence",
@@ -156469,7 +156481,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.1/enums/disclosure-persistence.json"
+      "$id": "/schemas/3.1.2/enums/disclosure-persistence.json"
     },
     "DisclosurePosition": {
       "title": "Disclosure Position",
@@ -156485,7 +156497,7 @@
         "pre_roll",
         "companion"
       ],
-      "$id": "/schemas/3.1.1/enums/disclosure-position.json"
+      "$id": "/schemas/3.1.2/enums/disclosure-position.json"
     },
     "ViewabilityStandard": {
       "title": "Viewability Standard",
@@ -156499,7 +156511,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.1/enums/viewability-standard.json"
+      "$id": "/schemas/3.1.2/enums/viewability-standard.json"
     },
     "ForecastRangeUnit": {
       "title": "Forecast Range Unit",
@@ -156525,7 +156537,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.1/enums/forecast-range-unit.json"
+      "$id": "/schemas/3.1.2/enums/forecast-range-unit.json"
     },
     "ForecastMethod": {
       "title": "Forecast Method",
@@ -156541,7 +156553,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.1/enums/forecast-method.json"
+      "$id": "/schemas/3.1.2/enums/forecast-method.json"
     },
     "ReachUnit": {
       "title": "Reach Unit",
@@ -156563,7 +156575,7 @@
         "cookies": "Unique browser cookies.",
         "custom": "Publisher-defined reach unit. Describe in ext."
       },
-      "$id": "/schemas/3.1.1/enums/reach-unit.json"
+      "$id": "/schemas/3.1.2/enums/reach-unit.json"
     },
     "MakegoodRemedy": {
       "title": "Makegood Remedy",
@@ -156579,7 +156591,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.1/enums/makegood-remedy.json"
+      "$id": "/schemas/3.1.2/enums/makegood-remedy.json"
     },
     "PerformanceStandardMetric": {
       "title": "Performance Standard Metric",
@@ -156599,7 +156611,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.1/enums/performance-standard-metric.json"
+      "$id": "/schemas/3.1.2/enums/performance-standard-metric.json"
     },
     "MediaBuyValidAction": {
       "title": "Media Buy Valid Action",
@@ -156803,7 +156815,7 @@
           ]
         }
       },
-      "$id": "/schemas/3.1.1/enums/media-buy-valid-action.json"
+      "$id": "/schemas/3.1.2/enums/media-buy-valid-action.json"
     },
     "MediaBuyActionMode": {
       "title": "Media Buy Action Mode",
@@ -156820,7 +156832,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.1/enums/media-buy-action-mode.json"
+      "$id": "/schemas/3.1.2/enums/media-buy-action-mode.json"
     },
     "MediaBuyStatus": {
       "title": "Media Buy Status",
@@ -156844,7 +156856,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.1/enums/media-buy-status.json"
+      "$id": "/schemas/3.1.2/enums/media-buy-status.json"
     },
     "ReportingFrequency": {
       "title": "Reporting Frequency",
@@ -156855,7 +156867,7 @@
         "daily",
         "monthly"
       ],
-      "$id": "/schemas/3.1.1/enums/reporting-frequency.json"
+      "$id": "/schemas/3.1.2/enums/reporting-frequency.json"
     },
     "AvailableMetric": {
       "title": "Available Metric",
@@ -156899,7 +156911,7 @@
         "conversion_lift",
         "brand_search_lift"
       ],
-      "$id": "/schemas/3.1.1/enums/available-metric.json"
+      "$id": "/schemas/3.1.2/enums/available-metric.json"
     },
     "CoBrandingRequirement": {
       "title": "Co-Branding Requirement",
@@ -156910,7 +156922,7 @@
         "optional",
         "none"
       ],
-      "$id": "/schemas/3.1.1/enums/co-branding-requirement.json"
+      "$id": "/schemas/3.1.2/enums/co-branding-requirement.json"
     },
     "LandingPageRequirement": {
       "title": "Landing Page Requirement",
@@ -156921,7 +156933,7 @@
         "retailer_site_only",
         "must_include_retailer"
       ],
-      "$id": "/schemas/3.1.1/enums/landing-page-requirement.json"
+      "$id": "/schemas/3.1.2/enums/landing-page-requirement.json"
     },
     "SignalValueType": {
       "title": "Signal Value Type",
@@ -156937,7 +156949,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.1/enums/signal-value-type.json"
+      "$id": "/schemas/3.1.2/enums/signal-value-type.json"
     },
     "CatalogType": {
       "title": "Catalog Type",
@@ -156958,7 +156970,7 @@
         "destination",
         "app"
       ],
-      "$id": "/schemas/3.1.1/enums/catalog-type.json"
+      "$id": "/schemas/3.1.2/enums/catalog-type.json"
     },
     "AssessmentStatus": {
       "title": "Assessment Status",
@@ -156976,7 +156988,7 @@
         "good": "Meets quality thresholds for most optimization goals",
         "excellent": "Exceeds quality thresholds across all dimensions"
       },
-      "$id": "/schemas/3.1.1/enums/assessment-status.json"
+      "$id": "/schemas/3.1.2/enums/assessment-status.json"
     },
     "ActionSource": {
       "title": "Action Source",
@@ -157004,7 +157016,7 @@
         "system_generated": "Event generated by an automated system",
         "other": "Other source (specify in ext)"
       },
-      "$id": "/schemas/3.1.1/enums/action-source.json"
+      "$id": "/schemas/3.1.2/enums/action-source.json"
     },
     "InstallmentStatus": {
       "title": "Installment Status",
@@ -157028,7 +157040,7 @@
         "aired": "Already broadcast (live/linear content)",
         "published": "Already released (on-demand content)"
       },
-      "$id": "/schemas/3.1.1/enums/installment-status.json"
+      "$id": "/schemas/3.1.2/enums/installment-status.json"
     },
     "ContentRatingSystem": {
       "title": "Content Rating System",
@@ -157060,7 +157072,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.1/enums/content-rating-system.json"
+      "$id": "/schemas/3.1.2/enums/content-rating-system.json"
     },
     "SpecialCategory": {
       "title": "Special Category",
@@ -157094,7 +157106,7 @@
         "reunion": "Reunion or anniversary special",
         "tribute": "Tribute or memorial special"
       },
-      "$id": "/schemas/3.1.1/enums/special-category.json"
+      "$id": "/schemas/3.1.2/enums/special-category.json"
     },
     "TalentRole": {
       "title": "Talent Role",
@@ -157122,7 +157134,7 @@
         "commentator": "Play-by-play or event commentator",
         "analyst": "Color commentator or subject matter analyst"
       },
-      "$id": "/schemas/3.1.1/enums/talent-role.json"
+      "$id": "/schemas/3.1.2/enums/talent-role.json"
     },
     "DerivativeType": {
       "title": "Derivative Type",
@@ -157142,7 +157154,7 @@
         "trailer": "Promotional content for the source installment",
         "bonus": "Supplementary content (behind-the-scenes, extended interviews, deleted segments)"
       },
-      "$id": "/schemas/3.1.1/enums/derivative-type.json"
+      "$id": "/schemas/3.1.2/enums/derivative-type.json"
     },
     "TMPResponseType": {
       "title": "TMP Response Type",
@@ -157160,7 +157172,7 @@
         "creative": "Inline creative manifest. Offers include full rendering details.",
         "deal": "Deal ID for programmatic execution. Offers include deal metadata."
       },
-      "$id": "/schemas/3.1.1/enums/response-type.json"
+      "$id": "/schemas/3.1.2/enums/response-type.json"
     },
     "UIDType": {
       "title": "UID Type",
@@ -157192,7 +157204,7 @@
         "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.1/enums/uid-type.json"
+      "$id": "/schemas/3.1.2/enums/uid-type.json"
     },
     "DayOfWeek": {
       "title": "Day of Week",
@@ -157207,7 +157219,7 @@
         "saturday",
         "sunday"
       ],
-      "$id": "/schemas/3.1.1/enums/day-of-week.json"
+      "$id": "/schemas/3.1.2/enums/day-of-week.json"
     },
     "AccountStatus": {
       "title": "Account Status",
@@ -157229,7 +157241,7 @@
         "suspended": "Was active, now paused — operations gated",
         "closed": "Was active, now terminated — terminal state"
       },
-      "$id": "/schemas/3.1.1/enums/account-status.json"
+      "$id": "/schemas/3.1.2/enums/account-status.json"
     },
     "BillingParty": {
       "title": "Billing Party",
@@ -157245,7 +157257,7 @@
         "agent": "Agent consolidates billing across brands and is invoiced by the seller",
         "advertiser": "Seller invoices the advertiser directly, even when a different operator places orders on their behalf"
       },
-      "$id": "/schemas/3.1.1/enums/billing-party.json"
+      "$id": "/schemas/3.1.2/enums/billing-party.json"
     },
     "PaymentTerms": {
       "title": "Payment Terms",
@@ -157267,7 +157279,7 @@
         "net_90": "Payment due within 90 days of invoice",
         "prepay": "Payment required before campaign delivery"
       },
-      "$id": "/schemas/3.1.1/enums/payment-terms.json"
+      "$id": "/schemas/3.1.2/enums/payment-terms.json"
     },
     "AccountScope": {
       "title": "Account Scope",
@@ -157285,7 +157297,7 @@
         "operator_brand": "Account is dedicated to a specific operator+brand combination",
         "agent": "Agent-scoped account with no brand- or operator-specific split. This is an account scoping result, not a hidden credential-implied default for requests that omit account."
       },
-      "$id": "/schemas/3.1.1/enums/account-scope.json"
+      "$id": "/schemas/3.1.2/enums/account-scope.json"
     },
     "CloudStorageProtocol": {
       "title": "Cloud Storage Protocol",
@@ -157296,7 +157308,7 @@
         "gcs",
         "azure_blob"
       ],
-      "$id": "/schemas/3.1.1/enums/cloud-storage-protocol.json"
+      "$id": "/schemas/3.1.2/enums/cloud-storage-protocol.json"
     },
     "NotificationType": {
       "title": "Notification Type",
@@ -157338,7 +157350,7 @@
         "signal.removed": "Sent when a signal is no longer available in the seller's wholesale signals feed for the subscriber's account scope. Payload: `wholesale-feed-webhook.json` carrying a `signal.removed` event with the signal id, optional removal reason, and cache scope. **notification_id**: equals `event.event_id`; re-emissions of the same logical change reuse the same value under a new `idempotency_key`.",
         "wholesale_feed.bulk_change": "Sent when one operation changes too many wholesale product-feed or wholesale signals-feed entities for useful per-entity pushes. Payload: `wholesale-feed-webhook.json` carrying a `wholesale_feed.bulk_change` event with one affected entity type, approximate count, and repair recommendation. Receivers SHOULD re-read the affected feed named by `affected_entity_type` via `get_products` or `get_signals`. **notification_id**: equals `event.event_id`; re-emissions of the same logical change reuse the same value under a new `idempotency_key`."
       },
-      "$id": "/schemas/3.1.1/enums/notification-type.json"
+      "$id": "/schemas/3.1.2/enums/notification-type.json"
     },
     "Pacing": {
       "title": "Pacing",
@@ -157354,7 +157366,7 @@
         "asap": "Spend remaining budget as quickly as possible",
         "front_loaded": "Allocate more remaining budget earlier in the remaining campaign period"
       },
-      "$id": "/schemas/3.1.1/enums/pacing.json"
+      "$id": "/schemas/3.1.2/enums/pacing.json"
     },
     "FeedFormat": {
       "title": "Feed Format",
@@ -157380,7 +157392,7 @@
         "openai_product_feed": "OpenAI Commerce product feed for ChatGPT shopping — a GMC-derived dialect adding ChatGPT-specific eligibility flags (is_eligible_search / is_eligible_checkout / is_eligible_ads). Spec: https://developers.openai.com/commerce/specs/file-upload/products",
         "custom": "A feed whose shape is not one of the named formats above. The buyer MUST supply feed_field_mappings to normalize it to the AdCP catalog item schema."
       },
-      "$id": "/schemas/3.1.1/enums/feed-format.json"
+      "$id": "/schemas/3.1.2/enums/feed-format.json"
     },
     "UpdateFrequency": {
       "title": "Update Frequency",
@@ -157392,7 +157404,7 @@
         "daily",
         "weekly"
       ],
-      "$id": "/schemas/3.1.1/enums/update-frequency.json"
+      "$id": "/schemas/3.1.2/enums/update-frequency.json"
     },
     "ContentIDType": {
       "title": "Content ID Type",
@@ -157412,7 +157424,7 @@
         "destination_id",
         "app_id"
       ],
-      "$id": "/schemas/3.1.1/enums/content-id-type.json"
+      "$id": "/schemas/3.1.2/enums/content-id-type.json"
     },
     "CanonicalFormatKind": {
       "title": "Canonical Format Kind",
@@ -157433,7 +157445,7 @@
         "agent_placement",
         "custom"
       ],
-      "$id": "/schemas/3.1.1/core/canonical-format-kind.json"
+      "$id": "/schemas/3.1.2/core/canonical-format-kind.json"
     },
     "AgeVerificationMethod": {
       "title": "Age Verification Method",
@@ -157446,7 +157458,7 @@
         "credit_card",
         "world_id"
       ],
-      "$id": "/schemas/3.1.1/enums/age-verification-method.json"
+      "$id": "/schemas/3.1.2/enums/age-verification-method.json"
     },
     "TravelTimeUnit": {
       "title": "Travel Time Unit",
@@ -157460,7 +157472,7 @@
         "min": "Minutes",
         "hr": "Hours"
       },
-      "$id": "/schemas/3.1.1/enums/travel-time-unit.json"
+      "$id": "/schemas/3.1.2/enums/travel-time-unit.json"
     },
     "TransportMode": {
       "title": "Transport Mode",
@@ -157478,7 +157490,7 @@
         "driving": "Motor vehicle travel on road networks",
         "public_transport": "Public transit including bus, rail, metro, and ferry"
       },
-      "$id": "/schemas/3.1.1/enums/transport-mode.json"
+      "$id": "/schemas/3.1.2/enums/transport-mode.json"
     },
     "DistanceUnit": {
       "title": "Distance Unit",
@@ -157494,7 +157506,7 @@
         "mi": "Miles",
         "m": "Meters"
       },
-      "$id": "/schemas/3.1.1/enums/distance-unit.json"
+      "$id": "/schemas/3.1.2/enums/distance-unit.json"
     },
     "MatchType": {
       "title": "Match Type",
@@ -157510,7 +157522,7 @@
         "phrase": "Ads serve when the query contains the keyword phrase in order",
         "exact": "Ads serve only when the query matches the keyword exactly"
       },
-      "$id": "/schemas/3.1.1/enums/match-type.json"
+      "$id": "/schemas/3.1.2/enums/match-type.json"
     },
     "CompletionSource": {
       "title": "Completion Source",
@@ -157524,7 +157536,7 @@
         "seller_attested": "The party serving the ad witnessed and counted the completion event. Includes ad-server / player completion beacons, walled-garden first-party measurement, and IAB-certified first-party podcast measurement on the platform's own inventory. Source of truth is the seller's delivery infrastructure.",
         "vendor_attested": "An independent third-party measurement vendor (Nielsen, DV, IAS, Moat, HUMAN, Podtrac on third-party inventory, Edison Research panel, etc.) attested to the completion via SDK callbacks, server-beacon validation, or panel methodology. Source of truth is the vendor; vendor identity SHOULD be anchored on a matching `performance_standard.vendor` BrandRef in the buy contract — if a buyer wants vendor-attested completion for transparency without an accountability gate, they MAY commit a vendor metric via `vendor_metrics` on the product rather than `committed_metrics` with this qualifier."
       },
-      "$id": "/schemas/3.1.1/enums/completion-source.json"
+      "$id": "/schemas/3.1.2/enums/completion-source.json"
     },
     "AttributionMethodology": {
       "title": "Attribution Methodology",
@@ -157542,7 +157554,7 @@
         "panel_based": "Panel methodology — outcomes measured against a recruited respondent panel and projected to the population. Standard for Nielsen, comScore, Edison Research, and similar panel providers.",
         "modeled": "Modeled output — Media Mix Modeling (MMM), Multi-Touch Attribution (MTA), incrementality testing, or other statistical inference that produces an estimated outcome rather than a directly-observed match. Includes most clean-room outputs."
       },
-      "$id": "/schemas/3.1.1/enums/attribution-methodology.json"
+      "$id": "/schemas/3.1.2/enums/attribution-methodology.json"
     },
     "LiftDimension": {
       "title": "Lift Dimension",
@@ -157562,7 +157574,7 @@
         "purchase_intent": "Lift in stated purchase intent — 'are you likely to buy [brand] in the next [N] days'.",
         "ad_recall": "Lift in unaided or aided ad recall — 'do you remember seeing an ad for [brand]'."
       },
-      "$id": "/schemas/3.1.1/enums/lift-dimension.json"
+      "$id": "/schemas/3.1.2/enums/lift-dimension.json"
     },
     "AttributionModel": {
       "title": "Attribution Model",
@@ -157575,7 +157587,7 @@
         "time_decay",
         "data_driven"
       ],
-      "$id": "/schemas/3.1.1/enums/attribution-model.json"
+      "$id": "/schemas/3.1.2/enums/attribution-model.json"
     },
     "CanceledBy": {
       "title": "Canceled By",
@@ -157589,7 +157601,7 @@
         "buyer": "Cancellation initiated by the buyer via update_media_buy",
         "seller": "Cancellation initiated by the seller (e.g., policy violation, inventory withdrawal)"
       },
-      "$id": "/schemas/3.1.1/enums/canceled-by.json"
+      "$id": "/schemas/3.1.2/enums/canceled-by.json"
     },
     "PricingModel": {
       "title": "Pricing Model",
@@ -157617,7 +157629,7 @@
         "flat_rate": "Flat Rate - fixed cost regardless of delivery volume (sponsorships, takeovers)",
         "time": "Time - cost per time unit (hour, day, week, or month) that scales with campaign duration"
       },
-      "$id": "/schemas/3.1.1/enums/pricing-model.json"
+      "$id": "/schemas/3.1.2/enums/pricing-model.json"
     },
     "FrameRateType": {
       "title": "Frame Rate Type",
@@ -157631,7 +157643,7 @@
         "constant": "Constant frame rate (CFR) — each frame occupies an identical time interval",
         "variable": "Variable frame rate (VFR) — frame intervals may differ"
       },
-      "$id": "/schemas/3.1.1/enums/frame-rate-type.json"
+      "$id": "/schemas/3.1.2/enums/frame-rate-type.json"
     },
     "ScanType": {
       "title": "Scan Type",
@@ -157645,7 +157657,7 @@
         "progressive": "All lines of each frame are drawn in sequence",
         "interlaced": "Alternating lines drawn in two passes per frame (legacy broadcast)"
       },
-      "$id": "/schemas/3.1.1/enums/scan-type.json"
+      "$id": "/schemas/3.1.2/enums/scan-type.json"
     },
     "GOPType": {
       "title": "GOP Type",
@@ -157659,7 +157671,7 @@
         "closed": "Each GOP is independently decodable — required for SSAI and broadcast splicing",
         "open": "GOPs may reference frames from adjacent GOPs — not suitable for splicing"
       },
-      "$id": "/schemas/3.1.1/enums/gop-type.json"
+      "$id": "/schemas/3.1.2/enums/gop-type.json"
     },
     "MoovAtomPosition": {
       "title": "Moov Atom Position",
@@ -157673,7 +157685,7 @@
         "start": "moov atom at beginning of file — enables progressive download and streaming delivery",
         "end": "moov atom at end of file — requires full download before playback can begin"
       },
-      "$id": "/schemas/3.1.1/enums/moov-atom-position.json"
+      "$id": "/schemas/3.1.2/enums/moov-atom-position.json"
     },
     "AudioChannelLayout": {
       "title": "Audio Channel Layout",
@@ -157685,7 +157697,7 @@
         "5.1",
         "7.1"
       ],
-      "$id": "/schemas/3.1.1/enums/audio-channel-layout.json"
+      "$id": "/schemas/3.1.2/enums/audio-channel-layout.json"
     },
     "VASTVersion": {
       "title": "VAST Version",
@@ -157698,7 +157710,7 @@
         "4.1",
         "4.2"
       ],
-      "$id": "/schemas/3.1.1/enums/vast-version.json"
+      "$id": "/schemas/3.1.2/enums/vast-version.json"
     },
     "VASTTrackingEvent": {
       "title": "VAST Tracking Event",
@@ -157742,7 +157754,7 @@
         "measurableImpression",
         "viewableImpression"
       ],
-      "$id": "/schemas/3.1.1/enums/vast-tracking-event.json"
+      "$id": "/schemas/3.1.2/enums/vast-tracking-event.json"
     },
     "URLAssetType": {
       "title": "URL Asset Type",
@@ -157753,7 +157765,7 @@
         "tracker_pixel",
         "tracker_script"
       ],
-      "$id": "/schemas/3.1.1/enums/url-asset-type.json"
+      "$id": "/schemas/3.1.2/enums/url-asset-type.json"
     },
     "JavaScriptModuleType": {
       "title": "JavaScript Module Type",
@@ -157764,7 +157776,7 @@
         "commonjs",
         "script"
       ],
-      "$id": "/schemas/3.1.1/enums/javascript-module-type.json"
+      "$id": "/schemas/3.1.2/enums/javascript-module-type.json"
     },
     "HTTPMethod": {
       "title": "HTTP Method",
@@ -157774,7 +157786,7 @@
         "GET",
         "POST"
       ],
-      "$id": "/schemas/3.1.1/enums/http-method.json",
+      "$id": "/schemas/3.1.2/enums/http-method.json",
       "default": "POST"
     },
     "UniversalMacro": {
@@ -157935,7 +157947,7 @@
         "ITEM_PRICE": "Price amount of the catalog item being rendered (catalog_field: price.amount). Catalog content macro — scalar text value substituted under the catalog-item substitution-safety rules.",
         "ITEM_PRICE_CURRENCY": "ISO 4217 currency code of the catalog item being rendered (catalog_field: price.currency). Catalog content macro — scalar text value substituted under the catalog-item substitution-safety rules."
       },
-      "$id": "/schemas/3.1.1/enums/universal-macro.json"
+      "$id": "/schemas/3.1.2/enums/universal-macro.json"
     },
     "WebhookResponseType": {
       "title": "Webhook Response Type",
@@ -157947,7 +157959,7 @@
         "xml",
         "javascript"
       ],
-      "$id": "/schemas/3.1.1/enums/webhook-response-type.json"
+      "$id": "/schemas/3.1.2/enums/webhook-response-type.json"
     },
     "WebhookSecurityMethod": {
       "title": "Webhook Security Method",
@@ -157958,7 +157970,7 @@
         "api_key",
         "none"
       ],
-      "$id": "/schemas/3.1.1/enums/webhook-security-method.json"
+      "$id": "/schemas/3.1.2/enums/webhook-security-method.json"
     },
     "DAASTVersion": {
       "title": "DAAST Version",
@@ -157968,7 +157980,7 @@
         "1.0",
         "1.1"
       ],
-      "$id": "/schemas/3.1.1/enums/daast-version.json"
+      "$id": "/schemas/3.1.2/enums/daast-version.json"
     },
     "DAASTTrackingEvent": {
       "title": "DAAST Tracking Event",
@@ -157999,7 +158011,7 @@
         "measurableImpression",
         "viewableImpression"
       ],
-      "$id": "/schemas/3.1.1/enums/daast-tracking-event.json"
+      "$id": "/schemas/3.1.2/enums/daast-tracking-event.json"
     },
     "MarkdownFlavor": {
       "title": "Markdown Flavor",
@@ -158009,7 +158021,7 @@
         "commonmark",
         "gfm"
       ],
-      "$id": "/schemas/3.1.1/enums/markdown-flavor.json",
+      "$id": "/schemas/3.1.2/enums/markdown-flavor.json",
       "default": "commonmark"
     },
     "RightUse": {
@@ -158045,7 +158057,7 @@
         "commercial": "Use in commercial advertising and promotional contexts",
         "ai_generated_image": "License to produce AI-generated still imagery derived from the rights holder's IP (brand assets, character designs, talent likeness). Distinct from likeness/voice by output modality — a get_rights query filtered on ai_generated_image returns rights whose pricing options cover image generation, regardless of the underlying IP category."
       },
-      "$id": "/schemas/3.1.1/enums/right-use.json"
+      "$id": "/schemas/3.1.2/enums/right-use.json"
     },
     "RightType": {
       "title": "Right Type",
@@ -158066,7 +158078,7 @@
         "music": "Rights to musical compositions or recordings (sync, background music)",
         "stock_media": "Rights to stock photography, video, or audio collections"
       },
-      "$id": "/schemas/3.1.1/enums/right-type.json"
+      "$id": "/schemas/3.1.2/enums/right-type.json"
     },
     "CreativeIdentifierType": {
       "title": "Creative Identifier Type",
@@ -158090,7 +158102,7 @@
         "clearcast_clock",
         "idcrea"
       ],
-      "$id": "/schemas/3.1.1/enums/creative-identifier-type.json"
+      "$id": "/schemas/3.1.2/enums/creative-identifier-type.json"
     },
     "DataProviderSignalSelector": {
       "title": "Data Provider Signal Selector",
@@ -158183,11 +158195,11 @@
           "additionalProperties": true
         }
       ],
-      "$id": "/schemas/3.1.1/core/data-provider-signal-selector.json"
+      "$id": "/schemas/3.1.2/core/data-provider-signal-selector.json"
     }
   },
   "_bundled": {
-    "generatedAt": "2026-06-30T19:14:40.809Z",
+    "generatedAt": "2026-07-08T13:55:49.344Z",
     "note": "This is a bundled schema with all $ref resolved inline. For the modular version with references, use the parent directory."
   }
 }