@adcp/sdk 15.8.0 → 15.9.0

package/dist/lib/schemas-data/3.2/core/forecast-vendor-metric-value.json

@@ -1,20 +1,20 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-vendor-metric-value.json",
+  "$id": "https://adcontextprotocol.org/schemas/3.2.4/core/forecast-vendor-metric-value.json",
   "title": "Forecast Vendor Metric Value",
   "description": "A forecasted value for a vendor-defined metric, emitted on ForecastPoint.vendor_metric_values parallel to delivery-metrics vendor_metric_values. The envelope mirrors VendorMetricValue but uses ForecastRange for value and the coverage denominators (measurable_impressions, measurable_plays, measurable_play_seconds) because forecasts may carry low/mid/high bounds instead of actual delivered values.",
   "type": "object",
   "properties": {
     "vendor": {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/brand-ref.json",
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/brand-ref.json",
       "description": "Vendor that defines and forecasts this metric. Matches a reporting_capabilities.vendor_metrics declaration on the product."
     },
     "metric_id": {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/vendor-metric-id.json",
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/vendor-metric-id.json",
       "description": "Identifier for the metric within the vendor's vocabulary. Matches a vendor_metrics[].metric_id declaration on the product."
     },
     "value": {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json",
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/forecast-range.json",
       "description": "Forecasted vendor metric value. Unit semantics are vendor-defined; see unit and the vendor's measurement-agent metric definition."
     },
     "unit": {
@@ -31,15 +31,15 @@
       ]
     },
     "measurable_impressions": {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json",
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/forecast-range.json",
       "description": "Forecasted number of impressions the vendor expects to be able to measure. Coverage denominator for the vendor metric; buyers compute estimated coverage as measurable_impressions / impressions when both are present. For play-based channels (DOOH, cinema, place-based) forecast measurable_plays or measurable_play_seconds instead."
     },
     "measurable_plays": {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json",
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/forecast-range.json",
       "description": "Forecasted number of plays the vendor expects to be able to measure. Coverage denominator for channels where a play, not an impression, is the atomic observation unit; buyers compute estimated coverage as measurable_plays / plays when both are present."
     },
     "measurable_play_seconds": {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/forecast-range.json",
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/forecast-range.json",
       "description": "Forecasted play-seconds (creative playout seconds summed across endpoints — screens, speakers, players) the vendor expects to be able to measure. Coverage denominator when the vendor meters exposure duration rather than discrete plays."
     },
     "breakdown": {

package/dist/lib/schemas-data/3.2/core/format-id.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://adcontextprotocol.org/schemas/3.2.3/core/format-id.json",
+  "$id": "https://adcontextprotocol.org/schemas/3.2.4/core/format-id.json",
   "title": "Format Reference (Structured Object)",
   "deprecated": true,
   "description": "**DEPRECATED in 3.2.** Legacy named-format reference retained for 3.x compatibility. This JSON object — never a plain string — identifies a format by its declaring agent and local slug, and may carry legacy logical dimensions, pixel ratio, or duration parameters. New products and manifests use canonical `format_options`, `format_kind`, and `format_option_ref`; creative-agent build routing uses `creative.supported_formats[].capability_id`.",

package/dist/lib/schemas-data/3.2/core/format-option-ref.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://adcontextprotocol.org/schemas/3.2.3/core/format-option-ref.json",
+  "$id": "https://adcontextprotocol.org/schemas/3.2.4/core/format-option-ref.json",
   "title": "Format Option Reference",
   "description": "Discriminated reference to a product format option. The global canonical shape is still named by `format_kind`; this reference selects one concrete product `format_options[]` entry. `scope: \"publisher\"` identifies a publisher-declared catalog option by `{ publisher_domain, format_option_id }`. `scope: \"product\"` identifies a product-local option by `format_option_id`; the enclosing package/product context supplies the namespace.",
   "type": "object",

package/dist/lib/schemas-data/3.2/core/format-shape-vocabulary.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://adcontextprotocol.org/schemas/3.2.3/core/format-shape-vocabulary.json",
+  "$id": "https://adcontextprotocol.org/schemas/3.2.4/core/format-shape-vocabulary.json",
   "title": "AdCP Format Shape Vocabulary Registry",
   "description": "Canonical registry of `format_shape` values used on `ProductFormatDeclaration` when `format_kind: \"custom\"`. Captures recognized creative-structure patterns that are NOT yet first-class canonical formats — composed/coordinated/sponsorship shapes that high-end publishers and broadcast networks sell as headline products. Each registry entry names a global shape; the seller's actual structure lives in `format_schema` (URI+digest reference to the seller-hosted or AAO-mirrored schema) so buyer agents can fetch and validate against a real schema rather than reasoning over an opaque ext blob.\n\n**Two-layer extensibility:**\n- **Canonical** (`format_kind: image`, `video_vast`, etc.): full spec coverage, stable contract.\n- **Custom + format_shape + format_schema** (`format_kind: \"custom\"`): recognized pattern, classified against this vocabulary, but the params/slots structure is supplied by a fetchable schema rather than baked into AdCP.\n\nNon-canonical `format_shape` values remain valid (validators MAY soft-warn) so adopters CAN ship a shape that isn't yet in the registry — adding entries is a vocabulary PR, not a major-version bump. Once a `format_shape` entry sees 2+ adopters with substantively similar `format_schema` content for 90+ days, the working group promotes it to a first-class canonical (creates `/schemas/formats/canonical/<name>.json`, adds the value to `canonical-format-kind.json`, retires the registry entry). See [adcp#3666](https://github.com/adcontextprotocol/adcp/issues/3666) for the promotion queue.\n\n**Promotion migration contract (normative).** Promotion is a wire-shape change for any consumer code branching on `format_kind == \"custom\"` — the same publisher's product now ships under `format_kind: \"<promoted_name>\"`. To avoid silent breakage:\n\n1. **Transition window.** When the working group promotes a `format_shape` to a first-class `format_kind`, sellers MAY ship a product under BOTH shapes during the transition window — two declarations on the same product's `format_options` array, one `format_kind: \"custom\"` + `format_shape: \"<name>\"` and one `format_kind: \"<promoted_name>\"`. Transition window is at minimum 90 days; the promotion PR sets the calendar.\n2. **Consumer-SDK deprecation warning.** SDKs encountering a `format_kind: \"custom\"` declaration whose `format_shape` matches an entry promoted to a first-class canonical SHOULD emit a structured deprecation warning via their lint channel (same pattern as `FORMAT_PROJECTION_FAILED` cross-boundary visibility) carrying `{ format_shape, promoted_to: format_kind, promotion_release, transition_end }`. Adopters branching on `format_kind == \"custom\"` past `transition_end` silently lose that publisher's inventory; the deprecation warning is the early signal.\n3. **`promotion_status` lifecycle.** When promotion is scheduled, the entry's `promotion_status` SHOULD update from `tracking — see adcp#3666` to `promoted to <format_kind> in <version>; transition ends <date>`. SDKs MAY read the registry at codegen / runtime to populate the deprecation warning's `transition_end`.\n4. **Producer-side hygiene.** After the transition window closes, sellers SHOULD drop the legacy `format_kind: \"custom\"` declaration and ship only the first-class canonical. Buyers MAY then assume `format_kind == \"custom\"` + `format_shape: \"<name>\"` is a long-tail / non-promoted shape, not a promoted-canonical-shipped-under-the-old-name.\n\nWithout this contract, every promotion event silently breaks adopter code branching on `format_kind == \"custom\"`. With it, the breakage surfaces as a structured warning during the transition window and adopters can update their branching ahead of the cutover.",
   "version": "1.1.0",

package/dist/lib/schemas-data/3.2/core/format.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://adcontextprotocol.org/schemas/3.2.3/core/format.json",
+  "$id": "https://adcontextprotocol.org/schemas/3.2.4/core/format.json",
   "title": "Format",
   "description": "**DEPRECATED in 3.2.** Legacy named-format definition retained for older 3.x peers and list_creative_formats compatibility projections. New products and creative agents author ProductFormatDeclaration canonical contracts instead.",
   "deprecated": true,
@@ -30,7 +30,7 @@
           "type": "array",
           "description": "Publisher-controlled elements rendered on top of buyer content at this asset's position (e.g., video player controls, publisher logos). Creative agents should avoid placing critical content (CTAs, logos, key copy) within overlay bounds.",
           "items": {
-            "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/overlay.json"
+            "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/overlay.json"
           }
         },
         "asset_group_id": {
@@ -69,7 +69,7 @@
           "type": "array",
           "description": "Publisher-controlled elements rendered on top of buyer content at this asset's position (e.g., carousel navigation arrows, slide indicators). Creative agents should avoid placing critical content within overlay bounds.",
           "items": {
-            "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/overlay.json"
+            "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/overlay.json"
           }
         }
       },
@@ -82,7 +82,7 @@
   },
   "properties": {
     "format_id": {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/format-id.json",
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/format-id.json",
       "description": "This format's own identifier — a structured object {agent_url, id}, not a string. See /schemas/core/format-id.json for the full shape."
     },
     "name": {
@@ -102,7 +102,7 @@
       "type": "array",
       "description": "List of parameters this format accepts in format_id. Template formats define which parameters (dimensions, duration, etc.) can be specified when instantiating the format. Empty or omitted means this is a concrete format with fixed parameters.",
       "items": {
-        "$ref": "https://adcontextprotocol.org/schemas/3.2.3/enums/format-id-parameter.json"
+        "$ref": "https://adcontextprotocol.org/schemas/3.2.4/enums/format-id-parameter.json"
       },
       "uniqueItems": true
     },
@@ -155,7 +155,7 @@
                 "description": "Maximum height for responsive renders"
               },
               "unit": {
-                "$ref": "https://adcontextprotocol.org/schemas/3.2.3/enums/dimension-unit.json",
+                "$ref": "https://adcontextprotocol.org/schemas/3.2.4/enums/dimension-unit.json",
                 "description": "Unit of measurement for width/height values. Defaults to 'px' when absent. Print formats use 'inches' or 'cm'."
               },
               "responsive": {
@@ -255,7 +255,7 @@
                     "const": "image"
                   },
                   "requirements": {
-                    "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/requirements/image-asset-requirements.json"
+                    "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/requirements/image-asset-requirements.json"
                   }
                 },
                 "required": [
@@ -278,7 +278,7 @@
                     "const": "video"
                   },
                   "requirements": {
-                    "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/requirements/video-asset-requirements.json"
+                    "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/requirements/video-asset-requirements.json"
                   }
                 },
                 "required": [
@@ -301,7 +301,7 @@
                     "const": "audio"
                   },
                   "requirements": {
-                    "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/requirements/audio-asset-requirements.json"
+                    "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/requirements/audio-asset-requirements.json"
                   }
                 },
                 "required": [
@@ -324,7 +324,7 @@
                     "const": "text"
                   },
                   "requirements": {
-                    "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/requirements/text-asset-requirements.json"
+                    "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/requirements/text-asset-requirements.json"
                   }
                 },
                 "required": [
@@ -347,7 +347,7 @@
                     "const": "markdown"
                   },
                   "requirements": {
-                    "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/requirements/markdown-asset-requirements.json"
+                    "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/requirements/markdown-asset-requirements.json"
                   }
                 },
                 "required": [
@@ -370,7 +370,7 @@
                     "const": "html"
                   },
                   "requirements": {
-                    "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/requirements/html-asset-requirements.json"
+                    "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/requirements/html-asset-requirements.json"
                   }
                 },
                 "required": [
@@ -393,7 +393,7 @@
                     "const": "css"
                   },
                   "requirements": {
-                    "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/requirements/css-asset-requirements.json"
+                    "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/requirements/css-asset-requirements.json"
                   }
                 },
                 "required": [
@@ -416,7 +416,7 @@
                     "const": "javascript"
                   },
                   "requirements": {
-                    "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/requirements/javascript-asset-requirements.json"
+                    "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/requirements/javascript-asset-requirements.json"
                   }
                 },
                 "required": [
@@ -459,7 +459,7 @@
                     "const": "vast"
                   },
                   "requirements": {
-                    "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/requirements/vast-asset-requirements.json"
+                    "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/requirements/vast-asset-requirements.json"
                   }
                 },
                 "required": [
@@ -482,7 +482,7 @@
                     "const": "daast"
                   },
                   "requirements": {
-                    "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/requirements/daast-asset-requirements.json"
+                    "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/requirements/daast-asset-requirements.json"
                   }
                 },
                 "required": [
@@ -505,7 +505,7 @@
                     "const": "url"
                   },
                   "requirements": {
-                    "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/requirements/url-asset-requirements.json"
+                    "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/requirements/url-asset-requirements.json"
                   }
                 },
                 "required": [
@@ -528,7 +528,7 @@
                     "const": "webhook"
                   },
                   "requirements": {
-                    "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/requirements/webhook-asset-requirements.json"
+                    "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/requirements/webhook-asset-requirements.json"
                   }
                 },
                 "required": [
@@ -571,7 +571,7 @@
                     "const": "catalog"
                   },
                   "requirements": {
-                    "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/requirements/catalog-requirements.json"
+                    "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/requirements/catalog-requirements.json"
                   }
                 },
                 "required": [
@@ -758,7 +758,7 @@
                           "const": "image"
                         },
                         "requirements": {
-                          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/requirements/image-asset-requirements.json"
+                          "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/requirements/image-asset-requirements.json"
                         }
                       },
                       "required": [
@@ -778,7 +778,7 @@
                           "const": "video"
                         },
                         "requirements": {
-                          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/requirements/video-asset-requirements.json"
+                          "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/requirements/video-asset-requirements.json"
                         }
                       },
                       "required": [
@@ -798,7 +798,7 @@
                           "const": "audio"
                         },
                         "requirements": {
-                          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/requirements/audio-asset-requirements.json"
+                          "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/requirements/audio-asset-requirements.json"
                         }
                       },
                       "required": [
@@ -818,7 +818,7 @@
                           "const": "text"
                         },
                         "requirements": {
-                          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/requirements/text-asset-requirements.json"
+                          "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/requirements/text-asset-requirements.json"
                         }
                       },
                       "required": [
@@ -838,7 +838,7 @@
                           "const": "markdown"
                         },
                         "requirements": {
-                          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/requirements/markdown-asset-requirements.json"
+                          "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/requirements/markdown-asset-requirements.json"
                         }
                       },
                       "required": [
@@ -858,7 +858,7 @@
                           "const": "html"
                         },
                         "requirements": {
-                          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/requirements/html-asset-requirements.json"
+                          "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/requirements/html-asset-requirements.json"
                         }
                       },
                       "required": [
@@ -878,7 +878,7 @@
                           "const": "css"
                         },
                         "requirements": {
-                          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/requirements/css-asset-requirements.json"
+                          "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/requirements/css-asset-requirements.json"
                         }
                       },
                       "required": [
@@ -898,7 +898,7 @@
                           "const": "javascript"
                         },
                         "requirements": {
-                          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/requirements/javascript-asset-requirements.json"
+                          "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/requirements/javascript-asset-requirements.json"
                         }
                       },
                       "required": [
@@ -935,7 +935,7 @@
                           "const": "vast"
                         },
                         "requirements": {
-                          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/requirements/vast-asset-requirements.json"
+                          "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/requirements/vast-asset-requirements.json"
                         }
                       },
                       "required": [
@@ -955,7 +955,7 @@
                           "const": "daast"
                         },
                         "requirements": {
-                          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/requirements/daast-asset-requirements.json"
+                          "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/requirements/daast-asset-requirements.json"
                         }
                       },
                       "required": [
@@ -975,7 +975,7 @@
                           "const": "url"
                         },
                         "requirements": {
-                          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/requirements/url-asset-requirements.json"
+                          "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/requirements/url-asset-requirements.json"
                         }
                       },
                       "required": [
@@ -995,7 +995,7 @@
                           "const": "webhook"
                         },
                         "requirements": {
-                          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/requirements/webhook-asset-requirements.json"
+                          "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/requirements/webhook-asset-requirements.json"
                         }
                       },
                       "required": [
@@ -1032,7 +1032,7 @@
                           "const": "catalog"
                         },
                         "requirements": {
-                          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/requirements/catalog-requirements.json"
+                          "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/requirements/catalog-requirements.json"
                         }
                       },
                       "required": [
@@ -1168,7 +1168,7 @@
       "items": {
         "anyOf": [
           {
-            "$ref": "https://adcontextprotocol.org/schemas/3.2.3/enums/universal-macro.json"
+            "$ref": "https://adcontextprotocol.org/schemas/3.2.4/enums/universal-macro.json"
           },
           {
             "type": "string",
@@ -1182,7 +1182,7 @@
       "deprecated": true,
       "description": "**DEPRECATED in 3.1. Removed at 4.0.** Use `list_transformers` instead — a transformer declares its own `input_format_ids`/`output_format_ids`, so build capability is a property of the transformer (the unit you select and that carries pricing), not a relationship hung on a format. Discover build capability via `list_transformers` (optionally filtered by `input_format_ids`/`output_format_ids`).\n\nMigration: sellers that expressed transform capability by hanging `input_format_ids` on a format SHOULD declare a transformer via `list_transformers` instead. Buyers SHOULD discover build capability via `list_transformers` rather than filtering formats.\n\n*Legacy behavior, retained for 3.1–3.x backward compatibility:* array of format IDs this format accepts as input creative manifests; when present, indicates this format can take existing creatives in these formats as input. SDKs reading 3.1 catalogs MUST continue to honor this field when present; 4.0+ SDKs MAY reject it. New code SHOULD NOT emit this field.",
       "items": {
-        "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/format-id.json"
+        "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/format-id.json"
       }
     },
     "output_format_ids": {
@@ -1190,7 +1190,7 @@
       "deprecated": true,
       "description": "**DEPRECATED in 3.1. Removed at 4.0.** Use `list_transformers` instead — a transformer declares its own `output_format_ids`, so what a builder can produce is a property of the transformer, not a relationship hung on a format. Discover via `list_transformers`.\n\nMigration: sellers that expressed multi-output build capability (e.g. a multi-publisher template) by hanging `output_format_ids` on a format SHOULD declare a transformer via `list_transformers` instead.\n\n*Legacy behavior, retained for 3.1–3.x backward compatibility:* array of format IDs this format can produce as output; when present, indicates this format can build creatives in these output formats. SDKs reading 3.1 catalogs MUST continue to honor this field when present; 4.0+ SDKs MAY reject it. New code SHOULD NOT emit this field.",
       "items": {
-        "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/format-id.json"
+        "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/format-id.json"
       }
     },
     "format_card": {
@@ -1198,7 +1198,7 @@
       "description": "Optional standard visual card (300x400px) for displaying this format in user interfaces. Can be rendered via preview_creative or pre-generated.",
       "properties": {
         "format_id": {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/format-id.json",
+          "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/format-id.json",
           "description": "Creative format defining the card layout (typically format_card_standard)"
         },
         "manifest": {
@@ -1218,7 +1218,7 @@
       "description": "Accessibility posture of this format. Declares the WCAG conformance level that creatives produced by this format will meet.",
       "properties": {
         "wcag_level": {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/enums/wcag-level.json",
+          "$ref": "https://adcontextprotocol.org/schemas/3.2.4/enums/wcag-level.json",
           "description": "WCAG conformance level that this format achieves. For format-rendered creatives, the format guarantees this level. For opaque creatives, the format requires assets that self-certify to this level."
         },
         "requires_accessible_assets": {
@@ -1234,7 +1234,7 @@
       "type": "array",
       "description": "Disclosure positions this format can render. Buyers use this to determine whether a format can satisfy their compliance requirements before submitting a creative. When omitted, the format makes no disclosure rendering guarantees — creative agents SHOULD treat this as incompatible with briefs that require specific disclosure positions. Values correspond to positions on creative-brief.json required_disclosures.",
       "items": {
-        "$ref": "https://adcontextprotocol.org/schemas/3.2.3/enums/disclosure-position.json"
+        "$ref": "https://adcontextprotocol.org/schemas/3.2.4/enums/disclosure-position.json"
       },
       "minItems": 1,
       "uniqueItems": true
@@ -1246,14 +1246,14 @@
         "type": "object",
         "properties": {
           "position": {
-            "$ref": "https://adcontextprotocol.org/schemas/3.2.3/enums/disclosure-position.json",
+            "$ref": "https://adcontextprotocol.org/schemas/3.2.4/enums/disclosure-position.json",
             "description": "The disclosure position"
           },
           "persistence": {
             "type": "array",
             "description": "Persistence modes this position supports",
             "items": {
-              "$ref": "https://adcontextprotocol.org/schemas/3.2.3/enums/disclosure-persistence.json"
+              "$ref": "https://adcontextprotocol.org/schemas/3.2.4/enums/disclosure-persistence.json"
             },
             "minItems": 1,
             "uniqueItems": true
@@ -1272,7 +1272,7 @@
       "description": "Optional detailed card with carousel and full specifications. Provides rich format documentation similar to ad spec pages.",
       "properties": {
         "format_id": {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/format-id.json",
+          "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/format-id.json",
           "description": "Creative format defining the detailed card layout (typically format_card_detailed)"
         },
         "manifest": {
@@ -1291,7 +1291,7 @@
       "type": "array",
       "description": "Metrics this format can produce in delivery reporting. Buyers receive the intersection of format reported_metrics and product available_metrics. Under `enums/available-metric.json`, a container such as `viewability` subsumes numeric leaves such as `viewable_rate`; structured distributions match only their explicit `viewed_seconds_percentiles` or `viewed_seconds_histogram` identities. If omitted, the format defers entirely to product-level metric declarations.",
       "items": {
-        "$ref": "https://adcontextprotocol.org/schemas/3.2.3/enums/available-metric.json"
+        "$ref": "https://adcontextprotocol.org/schemas/3.2.4/enums/available-metric.json"
       },
       "minItems": 1,
       "uniqueItems": true
@@ -1301,12 +1301,12 @@
       "deprecated": true,
       "description": "**DEPRECATED in 3.1. Removed at 4.0.** Use `transformer.pricing_options` (via `list_transformers`) instead — pricing belongs on the transformer (the unit selected and billed), exactly as it belongs on a media-buy product. Once formats only describe output shape, format-level pricing is vestigial.\n\nMigration: transformation/generation agents that charged via `format.pricing_options` SHOULD move the same `vendor-pricing-option` entries onto the corresponding transformer. The applied option is echoed per-leaf on the build_creative response and reconciled via report_usage, unchanged.\n\n*Legacy behavior, retained for 3.1–3.x backward compatibility:* pricing options for this format, used by transformation/generation agents that charge per format adapted, per image generated, or per unit of work; present when the request included include_pricing=true and account. SDKs reading 3.1 catalogs MUST continue to honor this field when present; 4.0+ SDKs MAY reject it. New code SHOULD NOT emit this field.",
       "items": {
-        "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/vendor-pricing-option.json"
+        "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/vendor-pricing-option.json"
       },
       "minItems": 1
     },
     "canonical": {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/canonical-projection-ref.json",
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/canonical-projection-ref.json",
       "description": "Optional v2 canonical-projection annotation. Always an object — bare-string shorthand (`canonical: \"image\"`) is not supported; the minimal form is `canonical: { \"kind\": \"image\" }`. Carries `kind` (which canonical the v1 format projects to) plus optional `asset_source` and `slots_override` for cases where the v1 format's shape doesn't follow the canonical's defaults (e.g., generative entries whose input is `generation_prompt: text` instead of `image_main: image`).\n\nWhen set, SDKs use this annotation as the authoritative v1 → v2 mapping for this format, bypassing the [v1 canonical mapping registry](/schemas/registries/v1-canonical-mapping.json) lookup. Combined with the slot-level `asset_group_id` declarations on each `assets[i]` entry, a v1 format declaration with `canonical` set is fully self-describing for v1↔v2 translation.\n\nResolution order for SDK projection from v1 wire shape to v2 (per RFC #3305 amendment #3767):\n1. If this `canonical` field is set, use it (seller-declared, highest priority). Apply `asset_source` and `slots_override` from the projection ref when present; otherwise inherit the canonical's defaults.\n2. Else, look up `format_id` in the canonical mapping registry's `format_id_glob` entries.\n3. Else, attempt structural match against the registry's `structural` entries (asset types, slot shape, vast_versions, etc.).\n4. Else, fail closed: SDK MUST NOT emit `format_options` for products carrying this format. Surface `FORMAT_PROJECTION_FAILED` on the response `errors[]` suggesting the seller add an explicit `canonical` annotation or file a registry entry.\n\nWhen `canonical.kind` is `custom`, the seller MUST also declare `canonical_format_shape` and `canonical_format_schema` (parallel to ProductFormatDeclaration's `format_shape` and `format_schema`) so buyer SDKs can fetch the seller's custom format schema.\n\nSee `canonical-projection-ref.json` for full projection semantics and examples (default-slot case, generative case, brief-driven case)."
     },
     "canonical_parameters": {
@@ -1314,7 +1314,7 @@
       "description": "**DEPRECATED in 3.1. Removed at 4.0.** Use `v1_format_ref` on the v2 `ProductFormatDeclaration` instead — the seller authors a v2 declaration (in `Product.format_options` or `creative.supported_formats`) and links it back to this v1 format via `v1_format_ref: { agent_url, id }`. The directional link from v2 → v1 is the same fact as `canonical_parameters` without the parallel-shape drift surface (v1 file and `canonical_parameters` were two declarations of the same thing; hand-authored, drifting silently).\n\nMigration: every seller currently authoring `canonical_parameters` SHOULD migrate to authoring a v2 declaration on the corresponding product (or capability) with `v1_format_ref` pointing back at this v1 format. v1 files become pure v1 again — no v2-shape mirroring.\n\n*Legacy behavior, retained for 3.1–3.x backward compatibility:* When `canonical` is set, this field carries the full ProductFormatDeclaration that the SDK projects this v1 format into. The `format_kind` MUST equal the `canonical` field value (validators enforce). When set, this is the authoritative source for SDK v1→v2 projection — the registry's structural-match parameter inference is bypassed. SDKs reading 3.1 catalogs MUST continue to honor `canonical_parameters` when present; 4.0+ SDKs MAY reject the field. New code SHOULD NOT emit this field. Seller execution authority is never projected through this deprecated field, so tracker_execution_contract and tracker_execution_contract_digest are forbidden.\n\n**Drift contract (still normative while supported).** Hand-authored `canonical_parameters` MUST satisfy the *narrows* relation against this v1 format's `requirements` and `assets[*]` shape (see canonical-formats.mdx 'Narrows — formal definition'). SDKs that read this v1 file SHOULD lint-time check the equivalence at build/load and emit `FORMAT_PROJECTION_FAILED` if the two disagree.",
       "allOf": [
         {
-          "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/product-format-declaration.json"
+          "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/product-format-declaration.json"
         },
         {
           "not": {

package/dist/lib/schemas-data/3.2/core/frequency-cap-constraints.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://adcontextprotocol.org/schemas/3.2.3/core/frequency-cap-constraints.json",
+  "$id": "https://adcontextprotocol.org/schemas/3.2.4/core/frequency-cap-constraints.json",
   "title": "Frequency Cap Constraints",
   "x-adcp-hoist": true,
   "description": "Structured frequency-cap constraints. Count and duration declarations are exact: each uses either an exhaustive preset list or an inclusive range, never a unit-only promise. At product scope, omitted fields inherit the applicable seller-wide capability and never broaden it. Product mutability describes implementation capability; MediaBuy.available_actions remains authoritative for a live buy.",
@@ -10,7 +10,7 @@
       "type": "array",
       "description": "Logical cap fields that can change after creation. An empty array means create-only. For example, [max_impressions] permits changing the count while keeping per and window fixed. Omission means update support is undeclared and the legacy broad meaning applies.",
       "items": {
-        "$ref": "https://adcontextprotocol.org/schemas/3.2.3/enums/frequency-cap-mutable-field.json"
+        "$ref": "https://adcontextprotocol.org/schemas/3.2.4/enums/frequency-cap-mutable-field.json"
       },
       "uniqueItems": true
     },
@@ -18,7 +18,7 @@
       "type": "array",
       "description": "FrequencyCap shapes accepted by the product. max_impressions_and_suppress means both controls may appear together and are enforced with AND semantics.",
       "items": {
-        "$ref": "https://adcontextprotocol.org/schemas/3.2.3/enums/frequency-cap-control-mode.json"
+        "$ref": "https://adcontextprotocol.org/schemas/3.2.4/enums/frequency-cap-control-mode.json"
       },
       "minItems": 1,
       "uniqueItems": true
@@ -27,20 +27,20 @@
       "type": "array",
       "description": "Entity granularities accepted by max_impressions caps.",
       "items": {
-        "$ref": "https://adcontextprotocol.org/schemas/3.2.3/enums/reach-unit.json"
+        "$ref": "https://adcontextprotocol.org/schemas/3.2.4/enums/reach-unit.json"
       },
       "minItems": 1,
       "uniqueItems": true
     },
     "max_impressions_constraints": {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/frequency-cap-impression-constraints.json",
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/frequency-cap-impression-constraints.json",
       "description": "Exact supported max_impressions presets or range."
     },
     "window_constraints": {
       "type": "array",
       "description": "Exact supported max_impressions.window intervals, one entry per duration unit.",
       "items": {
-        "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/frequency-cap-interval-constraints.json"
+        "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/frequency-cap-interval-constraints.json"
       },
       "minItems": 1,
       "uniqueItems": true
@@ -49,13 +49,13 @@
       "type": "array",
       "description": "Exact supported suppress cooldown intervals, one entry per duration unit.",
       "items": {
-        "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/frequency-cap-interval-constraints.json"
+        "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/frequency-cap-interval-constraints.json"
       },
       "minItems": 1,
       "uniqueItems": true
     },
     "ext": {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/ext.json"
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/ext.json"
     }
   },
   "anyOf": [

package/dist/lib/schemas-data/3.2/core/frequency-cap-duration-unit.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://adcontextprotocol.org/schemas/3.2.3/core/frequency-cap-duration-unit.json",
+  "$id": "https://adcontextprotocol.org/schemas/3.2.4/core/frequency-cap-duration-unit.json",
   "title": "Frequency Cap Duration Unit",
   "description": "A duration unit supported for a frequency-cap window or suppression period.",
   "type": "string",

package/dist/lib/schemas-data/3.2/core/frequency-cap-impression-constraints.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://adcontextprotocol.org/schemas/3.2.3/core/frequency-cap-impression-constraints.json",
+  "$id": "https://adcontextprotocol.org/schemas/3.2.4/core/frequency-cap-impression-constraints.json",
   "title": "Frequency Cap Impression Constraints",
   "description": "Exact supported values for max_impressions, declared as either an exhaustive preset list or an inclusive integer range. The two forms are mutually exclusive.",
   "type": "object",
@@ -23,7 +23,7 @@
       "uniqueItems": true
     },
     "ext": {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/ext.json"
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/ext.json"
     }
   },
   "oneOf": [

package/dist/lib/schemas-data/3.2/core/frequency-cap-interval-constraints.json

@@ -1,13 +1,13 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://adcontextprotocol.org/schemas/3.2.3/core/frequency-cap-interval-constraints.json",
+  "$id": "https://adcontextprotocol.org/schemas/3.2.4/core/frequency-cap-interval-constraints.json",
   "title": "Frequency Cap Interval Constraints",
   "x-adcp-hoist": true,
   "description": "Exact supported intervals for one duration unit, declared as either an exhaustive preset list or an inclusive integer range. The two forms are mutually exclusive.",
   "type": "object",
   "properties": {
     "unit": {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/frequency-cap-duration-unit.json"
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/frequency-cap-duration-unit.json"
     },
     "minimum_interval": {
       "type": "integer",
@@ -27,7 +27,7 @@
       "uniqueItems": true
     },
     "ext": {
-      "$ref": "https://adcontextprotocol.org/schemas/3.2.3/core/ext.json"
+      "$ref": "https://adcontextprotocol.org/schemas/3.2.4/core/ext.json"
     }
   },
   "required": [