Merge pull request #252 from adcontextprotocol/bokelley/regen-schemas-2026-04-21

chore(types): regenerate schemas from upstream spec

Author: bokelley

pyproject.toml

@@ -102,7 +102,13 @@ adcp = ["py.typed", "ADCP_VERSION", "signing/pg/*.sql"]
 [tool.black]
 line-length = 100
 target-version = ["py310", "py311", "py312"]
-extend-exclude = "/(tasks)\\.py$"
+# Skip auto-generated files. Running black on generated_poc/ during
+# pre-commit after `make regenerate-schemas` causes a stash conflict
+# (hook reformats, tries to re-apply over seller's already-modified
+# files, rolls back). The regen script already runs black on the
+# consolidated _generated.py; individual generated_poc/ files don't
+# need formatting at commit time. Mirrors the ruff extend-exclude.
+extend-exclude = "/(tasks|_generated|registry)\\.py$|/types/generated_poc/"
 
 [tool.ruff]
 line-length = 100

schemas/cache/account/report-usage-request.json

@@ -2,6 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "Report Usage Request",
   "description": "Reports how a vendor's service was consumed after campaign delivery. Used by orchestrators (DSPs, storefronts) to inform vendor agents (signals, governance, creative) what was used so the vendor can track earned revenue and verify billing. Records can span multiple accounts and campaigns in a single request.",
+  "x-mutates-state": true,
   "type": "object",
   "properties": {
     "adcp_major_version": {
@@ -31,7 +32,8 @@
           },
           "media_buy_id": {
             "type": "string",
-            "description": "Seller-assigned media buy identifier. Links this usage record to a specific media buy."
+            "description": "Seller-assigned media buy identifier. Links this usage record to a specific media buy.",
+            "x-entity": "media_buy"
           },
           "vendor_cost": {
             "type": "number",
@@ -45,7 +47,8 @@
           },
           "pricing_option_id": {
             "type": "string",
-            "description": "Pricing option identifier from the vendor's discovery response (e.g., get_signals, list_content_standards). The vendor uses this to verify the correct rate was applied."
+            "description": "Pricing option identifier from the vendor's discovery response (e.g., get_signals, list_content_standards). The vendor uses this to verify the correct rate was applied.",
+            "x-entity": "vendor_pricing_option"
           },
           "impressions": {
             "type": "integer",
@@ -59,23 +62,28 @@
           },
           "signal_agent_segment_id": {
             "type": "string",
-            "description": "Signal identifier from get_signals. Required for signals agents."
+            "description": "Signal identifier from get_signals. Required for signals agents.",
+            "x-entity": "signal_activation_id"
           },
           "standards_id": {
             "type": "string",
-            "description": "Content standards configuration identifier. Required for governance agents."
+            "description": "Content standards configuration identifier. Required for governance agents.",
+            "x-entity": "content_standards"
           },
           "rights_id": {
             "type": "string",
-            "description": "Rights grant identifier from acquire_rights. Required for brand/rights agents. Links usage records to specific rights grants for cap tracking, billing verification, and overage calculation."
+            "description": "Rights grant identifier from acquire_rights. Required for brand/rights agents. Links usage records to specific rights grants for cap tracking, billing verification, and overage calculation.",
+            "x-entity": "rights_grant"
           },
           "creative_id": {
             "type": "string",
-            "description": "Creative identifier from build_creative or list_creatives. Required for creative agents. Links usage records to specific creatives for billing verification."
+            "description": "Creative identifier from build_creative or list_creatives. Required for creative agents. Links usage records to specific creatives for billing verification.",
+            "x-entity": "creative"
           },
           "property_list_id": {
             "type": "string",
-            "description": "Property list identifier from list_property_lists. Required for property list agents. Links usage records to specific property lists for billing verification."
+            "description": "Property list identifier from list_property_lists. Required for property list agents. Links usage records to specific property lists for billing verification.",
+            "x-entity": "property_list"
           }
         },
         "required": [

schemas/cache/account/sync-accounts-request.json

@@ -2,6 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "Sync Accounts Request",
   "description": "Sync advertiser accounts with a seller using upsert semantics. The agent declares which brands it represents, who operates on each brand's behalf, and the billing model. The seller provisions or links accounts accordingly, returning per-account status.",
+  "x-mutates-state": true,
   "type": "object",
   "properties": {
     "adcp_major_version": {

schemas/cache/account/sync-accounts-response.json

@@ -21,7 +21,8 @@
             "properties": {
               "account_id": {
                 "type": "string",
-                "description": "Seller-assigned account identifier. Use this in subsequent create_media_buy and other account-scoped operations."
+                "description": "Seller-assigned account identifier. Use this in subsequent create_media_buy and other account-scoped operations.",
+                "x-entity": "account"
               },
               "brand": {
                 "$ref": "../core/brand-ref.json",

schemas/cache/account/sync-governance-request.json

@@ -2,6 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "Sync Governance Request",
   "description": "Sync governance agent endpoints against specific accounts. The seller persists these governance agents and calls them for approval during media buy lifecycle events via check_governance. Uses replace semantics: each call replaces any previously synced agents on the specified accounts. The seller MUST verify that the authenticated agent has authority over each referenced account before persisting governance agents.",
+  "x-mutates-state": true,
   "type": "object",
   "properties": {
     "adcp_major_version": {

schemas/cache/brand/acquire-rights-request.json

@@ -3,6 +3,7 @@
   "title": "Acquire Rights Request",
   "description": "Binding contractual request to acquire rights from a brand agent. Parallels create_media_buy \u2014 the buyer selects a pricing_option_id from a get_rights response and provides campaign details. The agent clears against existing contracts and returns terms, generation credentials, and disclosure requirements.",
   "x-status": "experimental",
+  "x-mutates-state": true,
   "type": "object",
   "properties": {
     "adcp_major_version": {
@@ -13,11 +14,13 @@
     },
     "rights_id": {
       "type": "string",
-      "description": "Rights offering identifier from get_rights response"
+      "description": "Rights offering identifier from get_rights response",
+      "x-entity": "rights_grant"
     },
     "pricing_option_id": {
       "type": "string",
-      "description": "Selected pricing option from the rights offering"
+      "description": "Selected pricing option from the rights offering",
+      "x-entity": "vendor_pricing_option"
     },
     "buyer": {
       "$ref": "../core/brand-ref.json",

schemas/cache/brand/acquire-rights-response.json

@@ -10,7 +10,8 @@
       "properties": {
         "rights_id": {
           "type": "string",
-          "description": "Rights grant identifier"
+          "description": "Rights grant identifier",
+          "x-entity": "rights_grant"
         },
         "status": {
           "type": "string",
@@ -19,7 +20,8 @@
         },
         "brand_id": {
           "type": "string",
-          "description": "Brand identifier of the rights subject"
+          "description": "Brand identifier of the rights subject",
+          "x-entity": "rights_holder_brand"
         },
         "terms": {
           "$ref": "rights-terms.json",
@@ -96,15 +98,17 @@
       "title": "AcquireRightsPendingApproval",
       "properties": {
         "rights_id": {
-          "type": "string"
+          "type": "string",
+          "x-entity": "rights_grant"
         },
         "status": {
           "type": "string",
           "const": "pending_approval",
           "description": "Rights require approval from the rights holder"
         },
         "brand_id": {
-          "type": "string"
+          "type": "string",
+          "x-entity": "rights_holder_brand"
         },
         "detail": {
           "type": "string",
@@ -137,15 +141,17 @@
       "title": "AcquireRightsRejected",
       "properties": {
         "rights_id": {
-          "type": "string"
+          "type": "string",
+          "x-entity": "rights_grant"
         },
         "status": {
           "type": "string",
           "const": "rejected",
           "description": "Rights request was rejected"
         },
         "brand_id": {
-          "type": "string"
+          "type": "string",
+          "x-entity": "rights_holder_brand"
         },
         "reason": {
           "type": "string",

schemas/cache/brand/creative-approval-request.json

@@ -2,6 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "Creative Approval Request",
   "description": "Payload submitted by the buyer to the approval_webhook URL from acquire_rights. Contains the creative for rights holder review before distribution.",
+  "x-mutates-state": true,
   "type": "object",
   "properties": {
     "adcp_major_version": {
@@ -12,11 +13,13 @@
     },
     "rights_id": {
       "type": "string",
-      "description": "Rights grant this creative was produced under"
+      "description": "Rights grant this creative was produced under",
+      "x-entity": "rights_grant"
     },
     "creative_id": {
       "type": "string",
-      "description": "Buyer-assigned creative identifier. Equivalent to OpenRTB crid. Used to track approval status across resubmissions."
+      "description": "Buyer-assigned creative identifier. Equivalent to OpenRTB crid. Used to track approval status across resubmissions.",
+      "x-entity": "creative"
     },
     "creative_url": {
       "type": "string",

schemas/cache/brand/creative-approval-response.json

@@ -13,11 +13,13 @@
           "description": "Creative has been approved for distribution"
         },
         "rights_id": {
-          "type": "string"
+          "type": "string",
+          "x-entity": "rights_grant"
         },
         "creative_id": {
           "type": "string",
-          "description": "Echo of the buyer's creative identifier"
+          "description": "Echo of the buyer's creative identifier",
+          "x-entity": "creative"
         },
         "creative_url": {
           "type": "string",
@@ -61,11 +63,13 @@
           "description": "Creative was rejected"
         },
         "rights_id": {
-          "type": "string"
+          "type": "string",
+          "x-entity": "rights_grant"
         },
         "creative_id": {
           "type": "string",
-          "description": "Echo of the buyer's creative identifier"
+          "description": "Echo of the buyer's creative identifier",
+          "x-entity": "creative"
         },
         "creative_url": {
           "type": "string",
@@ -110,11 +114,13 @@
           "description": "Creative is queued for review"
         },
         "rights_id": {
-          "type": "string"
+          "type": "string",
+          "x-entity": "rights_grant"
         },
         "creative_id": {
           "type": "string",
-          "description": "Echo of the buyer's creative identifier"
+          "description": "Echo of the buyer's creative identifier",
+          "x-entity": "creative"
         },
         "creative_url": {
           "type": "string",

schemas/cache/brand/get-brand-identity-request.json

@@ -12,7 +12,8 @@
     },
     "brand_id": {
       "type": "string",
-      "description": "Brand identifier from brand.json brands array"
+      "description": "Brand identifier from brand.json brands array",
+      "x-entity": "advertiser_brand"
     },
     "fields": {
       "type": "array",