@adcp/sdk 13.0.1 → 13.0.3

package/dist/lib/schemas-data/3.1/manifest.json

@@ -1,7 +1,7 @@
 {
-  "$schema": "/schemas/3.1.15/manifest.schema.json",
-  "adcp_version": "3.1.15",
-  "generated_at": "2026-08-16T19:12:16.453Z",
+  "$schema": "/schemas/3.1.20/manifest.schema.json",
+  "adcp_version": "3.1.20",
+  "generated_at": "2026-09-02T12:43:39.182Z",
   "tools": {
     "acquire_rights": {
       "protocol": "brand",
@@ -1357,6 +1357,7 @@
         "sync_governance"
       ],
       "exercised_tools": [
+        "assert_contribution",
         "create_media_buy",
         "expect_webhook",
         "get_adcp_capabilities",
@@ -1406,6 +1407,7 @@
         "sync_governance"
       ],
       "exercised_tools": [
+        "assert_contribution",
         "create_media_buy",
         "get_adcp_capabilities",
         "get_media_buy_delivery",
@@ -1426,6 +1428,7 @@
         "sync_governance"
       ],
       "exercised_tools": [
+        "assert_contribution",
         "create_media_buy",
         "get_adcp_capabilities",
         "get_media_buy_delivery",
@@ -1448,6 +1451,7 @@
         "get_products"
       ],
       "exercised_tools": [
+        "assert_contribution",
         "create_media_buy",
         "get_adcp_capabilities",
         "get_media_buy_delivery",

package/dist/lib/schemas-data/3.1/manifest.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/manifest.schema.json",
+  "$id": "/schemas/3.1.20/manifest.schema.json",
   "title": "AdCP Manifest",
   "description": "Machine-readable registry of every AdCP tool, error code, and specialism for a given AdCP version. SDKs consume this artifact at codegen time to derive their tool/error tables instead of hand-transcribing the spec. Replaces three categories of drift documented in adcp#3725: hand-rolled tool-by-protocol arrays, hand-classified error recovery, and hand-listed specialism→tool mappings.",
   "type": "object",

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

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/media-buy/build-creative-async-response-input-required.json",
+  "$id": "/schemas/3.1.20/media-buy/build-creative-async-response-input-required.json",
   "title": "Build Creative - Input Required",
   "description": "Payload when build_creative is paused waiting for user input. May occur during generation when the agent needs creative direction, or when brand guidelines require approval.",
   "type": "object",
@@ -18,14 +18,14 @@
       "type": "array",
       "description": "Optional validation errors or warnings explaining why input is required.",
       "items": {
-        "$ref": "/schemas/3.1.15/core/error.json"
+        "$ref": "/schemas/3.1.20/core/error.json"
       }
     },
     "context": {
-      "$ref": "/schemas/3.1.15/core/context.json"
+      "$ref": "/schemas/3.1.20/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.1.15/core/ext.json"
+      "$ref": "/schemas/3.1.20/core/ext.json"
     }
   },
   "additionalProperties": true

package/dist/lib/schemas-data/3.1/media-buy/build-creative-async-response-submitted.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/media-buy/build-creative-async-response-submitted.json",
+  "$id": "/schemas/3.1.20/media-buy/build-creative-async-response-submitted.json",
   "title": "Build Creative - Submitted",
   "description": "Async task envelope returned when build_creative cannot be confirmed before the response — for example, when a slow generative pipeline or multi-minute LLM workflow is queued. The buyer polls tasks/get with task_id or receives a webhook when the task completes; the creative_manifest(s) land on the completion artifact, not this envelope.",
   "type": "object",
@@ -24,14 +24,14 @@
       "type": "array",
       "description": "Optional advisory errors accompanying the submitted envelope. Use only for non-blocking warnings (e.g., throttled_severity advisories, governance observations). Terminal failures belong in the error branch, not here.",
       "items": {
-        "$ref": "/schemas/3.1.15/core/error.json"
+        "$ref": "/schemas/3.1.20/core/error.json"
       }
     },
     "context": {
-      "$ref": "/schemas/3.1.15/core/context.json"
+      "$ref": "/schemas/3.1.20/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.1.15/core/ext.json"
+      "$ref": "/schemas/3.1.20/core/ext.json"
     }
   },
   "required": [

package/dist/lib/schemas-data/3.1/media-buy/build-creative-async-response-working.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/media-buy/build-creative-async-response-working.json",
+  "$id": "/schemas/3.1.20/media-buy/build-creative-async-response-working.json",
   "title": "Build Creative - Working",
   "description": "Progress payload for active build_creative task. Returned during AI generation, format transformation, or complex library retrieval with macro resolution.",
   "type": "object",
@@ -26,10 +26,10 @@
       "description": "Current step number"
     },
     "context": {
-      "$ref": "/schemas/3.1.15/core/context.json"
+      "$ref": "/schemas/3.1.20/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.1.15/core/ext.json"
+      "$ref": "/schemas/3.1.20/core/ext.json"
     }
   },
   "additionalProperties": true

package/dist/lib/schemas-data/3.1/media-buy/build-creative-request.json

@@ -1,12 +1,12 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/media-buy/build-creative-request.json",
+  "$id": "/schemas/3.1.20/media-buy/build-creative-request.json",
   "title": "Build Creative Request",
   "description": "Request to transform, generate, refine, or retrieve a creative manifest. Supports four modes: (1) generation from a brief or seed assets, (2) transformation of an existing manifest, (3) refinement of a prior produced variant via refine_from_build_variant_id (re-build with a natural-language message + config delta), (4) retrieval from a creative library by creative_id. Produces target manifest(s) in the specified format(s). Provide either target_format_id for a single format or target_format_ids for multiple formats.",
   "type": "object",
   "allOf": [
     {
-      "$ref": "/schemas/3.1.15/core/version-envelope.json"
+      "$ref": "/schemas/3.1.20/core/version-envelope.json"
     },
     {
       "$comment": "target_format_id and target_format_ids are mutually exclusive (single vs multi).",
@@ -34,7 +34,7 @@
       "description": "Natural language instructions for the transformation or generation. For pure generation, this is the creative brief. For transformation, this provides guidance on how to adapt the creative. For refinement, this describes the desired changes."
     },
     "creative_manifest": {
-      "$ref": "/schemas/3.1.15/core/creative-manifest.json",
+      "$ref": "/schemas/3.1.20/core/creative-manifest.json",
       "description": "Creative manifest to transform or generate from. For pure generation, this should include the target format_id and any required input assets. For transformation (e.g., resizing, reformatting), this is the complete creative to adapt. When creative_id is provided, the agent resolves the creative from its library and this field is ignored."
     },
     "creative_id": {
@@ -57,13 +57,13 @@
       "x-entity": "package"
     },
     "target_format_id": {
-      "$ref": "/schemas/3.1.15/core/format-id.json",
+      "$ref": "/schemas/3.1.20/core/format-id.json",
       "description": "Single format ID to generate. Mutually exclusive with target_format_ids. The format definition specifies required input assets and output structure."
     },
     "target_format_ids": {
       "type": "array",
       "items": {
-        "$ref": "/schemas/3.1.15/core/format-id.json"
+        "$ref": "/schemas/3.1.20/core/format-id.json"
       },
       "minItems": 1,
       "description": "Array of format IDs to generate in a single call. Mutually exclusive with target_format_id. The creative agent produces one manifest per format. Each format definition specifies its own required input assets and output structure."
@@ -125,7 +125,7 @@
       "items": {
         "allOf": [
           {
-            "$ref": "/schemas/3.1.15/core/signal-targeting.json"
+            "$ref": "/schemas/3.1.20/core/signal-targeting.json"
           },
           {
             "properties": {
@@ -193,24 +193,24 @@
       "description": "Advisory hint for how the buyer intends to use the variants. `keep_one` (best-of-N) and `keep_some` signal the agent to set `recommended`/`rank` on returned variants. Advisory only — it does not change what is returned or billed; every produced variant is returned and charged. Keeping is a client act of trafficking the chosen build_variant_id(s)."
     },
     "selection_strategy": {
-      "$ref": "/schemas/3.1.15/enums/creative-selection-strategy.json",
+      "$ref": "/schemas/3.1.20/enums/creative-selection-strategy.json",
       "x-status": "experimental",
       "description": "Governs HOW the agent samples when max_creatives < items_total (folds #5262). audience_relevance draws its ranking input from the SAME signal_ref pointers in signal_conditions / package targeting — NOT a parallel signals[] array. proximity takes a location input (geo shape TBD — WG open). inventory_priority is seller-side catalog metadata (margin/overstock/promo; no buyer input). random is the status-quo default. Per-creative selection ordering surfaces on the existing rank / recommended fields of creatives[].variants[], not a new selection_rank. Advisory; absent => agent default (random)."
     },
     "account": {
-      "$ref": "/schemas/3.1.15/core/account-ref.json",
+      "$ref": "/schemas/3.1.20/core/account-ref.json",
       "description": "Account reference for pricing and billing. When present, the creative agent applies account-specific pricing from the rate card, records the build against the account for billing, and can enforce account-level quotas or entitlements. Required by creative agents that charge for their services."
     },
     "brand": {
-      "$ref": "/schemas/3.1.15/core/brand-ref.json",
+      "$ref": "/schemas/3.1.20/core/brand-ref.json",
       "description": "Brand reference for creative generation. Resolved to full brand identity (colors, logos, tone) at execution time."
     },
     "quality": {
-      "$ref": "/schemas/3.1.15/enums/creative-quality.json",
+      "$ref": "/schemas/3.1.20/enums/creative-quality.json",
       "description": "Quality tier for generation. 'draft' produces fast, lower-fidelity output for iteration and review. 'production' produces full-quality output for final delivery. If omitted, the creative agent uses its own default. For non-generative transforms (e.g., format resizing), creative agents MAY ignore this field."
     },
     "evaluator": {
-      "$ref": "/schemas/3.1.15/core/evaluator-spec.json",
+      "$ref": "/schemas/3.1.20/core/evaluator-spec.json",
       "x-status": "experimental",
       "description": "Optional advisory evaluator (buyer-attached pointer, #5280) declaring how produced variants should be evaluated and ranked — the rank-side of the get_creative_features feature oracle. Experimental (x-status: experimental): the whole evaluator surface is new and unfrozen, and requires creative.supports_evaluator, which sellers MUST pair with `creative.evaluator` in experimental_features. Drives the producing agent's gate-then-rank pipeline over its best_of_n exploration: per leaf, evaluate (the chosen form) → optionally GATE (`evaluator.feature_requirement[]`, drop fails — internal pruning of which leaves the agent recommends, never an AdCP-layer block of an already-produced billable leaf) → RANK survivors (`evaluator.rank_by`, an explicit {feature_id, direction} ordering). Feature discovery uses get_adcp_capabilities governance.creative_features for rank_by, feature_requirement, and eval.features[]; evaluator_id is a pre-provisioned/account-arranged preset, not an ID discovered from that catalog. Populates a per-leaf `eval` block of creative-feature values (creative-feature-result[]) when supports_evaluator. When the evaluator names an external agent (`evaluator.feature_agent.agent_url` or the agent-form `agent_url`), that agent MUST appear in the seller's `creative_policy.accepted_verifiers[]` (the same allowlist #5280 established for provenance verify_agent); an off-list agent is rejected with `EVALUATOR_AGENT_NOT_ACCEPTED`. The outbound evaluator call authenticates on the transport (request signing/JWKS, mTLS, or a pre-provisioned static credential); credentials and caller-supplied trust material MUST NOT appear in evaluator, context, ext, or creative payload fields, and credential- or trust-material keys should be rejected with `CREDENTIAL_IN_ARGS`. With no `feature_requirement`, evaluation is advisory only and does not change what is produced or billed; an unreachable/unknown on-list agent degrades to seller-default ranking (advisory errors[] note), not a failure. Requires creative.supports_evaluator; otherwise ignored."
     },
@@ -253,11 +253,11 @@
       "minItems": 1
     },
     "preview_quality": {
-      "$ref": "/schemas/3.1.15/enums/creative-quality.json",
+      "$ref": "/schemas/3.1.20/enums/creative-quality.json",
       "description": "Render quality for inline preview when include_preview is true. 'draft' produces fast, lower-fidelity renderings. 'production' produces full-quality renderings. Independent of the build quality parameter — you can build at draft quality and preview at production quality, or vice versa. If omitted, the creative agent uses its own default. Ignored when include_preview is false or omitted."
     },
     "preview_output_format": {
-      "$ref": "/schemas/3.1.15/enums/preview-output-format.json",
+      "$ref": "/schemas/3.1.20/enums/preview-output-format.json",
       "default": "url",
       "description": "Output format for preview renders when include_preview is true. 'url' returns preview_url (iframe-embeddable URL), 'html' returns preview_html (raw HTML). Ignored when include_preview is false or omitted."
     },
@@ -276,14 +276,14 @@
       "pattern": "^[A-Za-z0-9_.:-]{16,255}$"
     },
     "push_notification_config": {
-      "$ref": "/schemas/3.1.15/core/push-notification-config.json",
+      "$ref": "/schemas/3.1.20/core/push-notification-config.json",
       "description": "Optional webhook configuration for async terminal completion/failure notifications on build_creative. Meaningful only when the request enters the async lifecycle and returns a Submitted envelope. Submitted envelopes with `task_id` remain pollable through `get_task_status` (legacy `tasks/get`) whether or not this field is present. If a request includes this field and the agent returns a Submitted envelope, the agent MUST deliver at least the terminal completion/failure notification to the configured URL; intermediate progress notifications are MAY. If the agent cannot honor the webhook channel, it MUST reject the request with a structured error instead of silently accepting. This field does not change response timing semantics: agents MUST NOT route a request through the async/Submitted arm or emit async delivery solely because `push_notification_config` is present; requests that can be completed inline still return the synchronous success shape."
     },
     "context": {
-      "$ref": "/schemas/3.1.15/core/context.json"
+      "$ref": "/schemas/3.1.20/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.1.15/core/ext.json"
+      "$ref": "/schemas/3.1.20/core/ext.json"
     }
   },
   "required": [

package/dist/lib/schemas-data/3.1/media-buy/build-creative-response.json

@@ -1,15 +1,15 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/media-buy/build-creative-response.json",
+  "$id": "/schemas/3.1.20/media-buy/build-creative-response.json",
   "title": "Build Creative Response",
   "description": "Response payload for build_creative. Exactly one of six shapes: (1) synchronous single-format success — creative_manifest issued in-line (target_format_id request); (2) synchronous multi-format success — creative_manifests issued in-line (target_format_ids request); (3) multiplicity success — creatives[] each carrying variants[], returned when the request used item (max_creatives) and/or variant (max_variants) fan-out; (4) dry-run estimate — mode 'estimate' returns a BuildCreativeEstimate cost band and produces/bills nothing; (5) terminal failure — an errors array; (6) submitted task envelope — status 'submitted' with task_id when the build is queued (e.g., slow generative or multi-minute LLM pipeline). The submitted branch MAY carry advisory errors for non-blocking warnings; terminal failures belong in the error branch. These six shapes are mutually exclusive — a response has exactly one.",
   "type": "object",
   "allOf": [
     {
-      "$ref": "/schemas/3.1.15/core/version-envelope.json"
+      "$ref": "/schemas/3.1.20/core/version-envelope.json"
     },
     {
-      "$ref": "/schemas/3.1.15/core/protocol-envelope.json"
+      "$ref": "/schemas/3.1.20/core/protocol-envelope.json"
     }
   ],
   "oneOf": [
@@ -19,7 +19,7 @@
       "type": "object",
       "properties": {
         "creative_manifest": {
-          "$ref": "/schemas/3.1.15/core/creative-manifest.json",
+          "$ref": "/schemas/3.1.20/core/creative-manifest.json",
           "description": "The generated or transformed creative manifest"
         },
         "build_variant_id": {
@@ -58,7 +58,7 @@
                     "type": "array",
                     "description": "Array of rendered pieces for this preview variant. Most formats render as a single piece. Companion ad formats render as multiple pieces.",
                     "items": {
-                      "$ref": "/schemas/3.1.15/creative/preview-render.json"
+                      "$ref": "/schemas/3.1.20/creative/preview-render.json"
                     },
                     "minItems": 1
                   },
@@ -113,7 +113,7 @@
           ]
         },
         "preview_error": {
-          "$ref": "/schemas/3.1.15/core/error.json",
+          "$ref": "/schemas/3.1.20/core/error.json",
           "description": "When include_preview was true in the request but preview generation failed. Uses the standard error structure with code, message, and recovery classification. Distinguishes 'agent does not support inline preview' (preview and preview_error both absent) from 'preview generation failed' (preview absent, preview_error present). Omitted when preview succeeded or was not requested."
         },
         "pricing_option_id": {
@@ -132,14 +132,14 @@
           "description": "ISO 4217 currency code for vendor_cost."
         },
         "consumption": {
-          "$ref": "/schemas/3.1.15/core/creative-consumption.json",
+          "$ref": "/schemas/3.1.20/core/creative-consumption.json",
           "description": "Structured consumption details for this build. Informational — lets the buyer verify that vendor_cost is consistent with the rate card. vendor_cost is the billing source of truth."
         },
         "context": {
-          "$ref": "/schemas/3.1.15/core/context.json"
+          "$ref": "/schemas/3.1.20/core/context.json"
         },
         "ext": {
-          "$ref": "/schemas/3.1.15/core/ext.json"
+          "$ref": "/schemas/3.1.20/core/ext.json"
         }
       },
       "required": [
@@ -155,7 +155,7 @@
         "creative_manifests": {
           "type": "array",
           "items": {
-            "$ref": "/schemas/3.1.15/core/creative-manifest.json"
+            "$ref": "/schemas/3.1.20/core/creative-manifest.json"
           },
           "minItems": 1,
           "description": "Array of generated creative manifests, one per requested format. Each manifest contains its own format_id identifying which format it was generated for."
@@ -184,14 +184,14 @@
                     "description": "Unique identifier for this preview"
                   },
                   "format_id": {
-                    "$ref": "/schemas/3.1.15/core/format-id.json",
+                    "$ref": "/schemas/3.1.20/core/format-id.json",
                     "description": "The format this preview was generated for. Matches one of the requested target_format_ids."
                   },
                   "renders": {
                     "type": "array",
                     "description": "Array of rendered pieces for this format's preview. Most formats render as a single piece. Companion ad formats render as multiple pieces.",
                     "items": {
-                      "$ref": "/schemas/3.1.15/creative/preview-render.json"
+                      "$ref": "/schemas/3.1.20/creative/preview-render.json"
                     },
                     "minItems": 1
                   },
@@ -247,7 +247,7 @@
           ]
         },
         "preview_error": {
-          "$ref": "/schemas/3.1.15/core/error.json",
+          "$ref": "/schemas/3.1.20/core/error.json",
           "description": "When include_preview was true in the request but preview generation failed. Uses the standard error structure with code, message, and recovery classification. Omitted when preview succeeded or was not requested."
         },
         "pricing_option_id": {
@@ -266,14 +266,14 @@
           "description": "ISO 4217 currency code for vendor_cost."
         },
         "consumption": {
-          "$ref": "/schemas/3.1.15/core/creative-consumption.json",
+          "$ref": "/schemas/3.1.20/core/creative-consumption.json",
           "description": "Structured consumption details for this build. Informational — lets the buyer verify that vendor_cost is consistent with the rate card."
         },
         "context": {
-          "$ref": "/schemas/3.1.15/core/context.json"
+          "$ref": "/schemas/3.1.20/core/context.json"
         },
         "ext": {
-          "$ref": "/schemas/3.1.15/core/ext.json"
+          "$ref": "/schemas/3.1.20/core/ext.json"
         }
       },
       "required": [
@@ -315,7 +315,7 @@
                 "additionalProperties": true
               },
               "signal_condition": {
-                "$ref": "/schemas/3.1.15/core/signal-targeting.json",
+                "$ref": "/schemas/3.1.20/core/signal-targeting.json",
                 "x-status": "experimental",
                 "description": "When this creative group was produced by fanning out over signal_conditions, the SignalTargeting condition this group is FOR (e.g. weather=rain). Sibling to catalog_item_ref. Carries the SAME signal_ref identity the sales-side package targeting uses, so a sales agent can structurally match condition identity and reject-at-trafficking (SIGNAL_TARGETING_INCOMPATIBLE) when a creative is assigned to an incompatible package."
               },
@@ -340,7 +340,7 @@
                       "description": "When this variant was produced by refining a prior build (request `refine_from_build_variant_id`), the source leaf's `build_variant_id` — establishing refinement lineage (a leaf may itself be refined, forming a chain). Absent for first-generation builds. AI-derivative attribution rides the manifest's existing `provenance`; this field carries only the lineage edge."
                     },
                     "creative_manifest": {
-                      "$ref": "/schemas/3.1.15/core/creative-manifest.json",
+                      "$ref": "/schemas/3.1.20/core/creative-manifest.json",
                       "description": "The generated creative for this variant. Carries its own format_id."
                     },
                     "variant_axis_value": {
@@ -364,7 +364,7 @@
                           "type": "array",
                           "description": "Creative-feature values the evaluator measured for this leaf — `creative-feature-result[]` (e.g., a `creative_quality_score` number, an `on_brief` categorical, a calibrated `predicted_performance` in [0,1] from the exemplars form). The gate (evaluator.feature_requirement[]) and ranking (evaluator.rank_by) are evaluated over these values. Same shape get_creative_features returns.",
                           "items": {
-                            "$ref": "/schemas/3.1.15/creative/creative-feature-result.json"
+                            "$ref": "/schemas/3.1.20/creative/creative-feature-result.json"
                           }
                         },
                         "ranked_against": {
@@ -383,7 +383,7 @@
                           "description": "Wall-clock seconds consumed during evaluation. Sellers SHOULD populate when agent_url was used and an eval_budget was supplied, giving buyers visibility into external call usage. No billing coupling in v1."
                         },
                         "ext": {
-                          "$ref": "/schemas/3.1.15/core/ext.json"
+                          "$ref": "/schemas/3.1.20/core/ext.json"
                         }
                       },
                       "additionalProperties": true
@@ -404,7 +404,7 @@
                       "description": "ISO 4217 currency code for vendor_cost. Co-required with vendor_cost."
                     },
                     "consumption": {
-                      "$ref": "/schemas/3.1.15/core/creative-consumption.json",
+                      "$ref": "/schemas/3.1.20/core/creative-consumption.json",
                       "description": "Structured consumption for this variant leaf. Informational; vendor_cost is the billing source of truth."
                     }
                   },
@@ -432,7 +432,7 @@
                 "type": "array",
                 "description": "Per-creative errors when this catalog item failed to build. Present only on failed items; does not fail the batch (per-item non-atomic). A failed entry carries errors[] and no variants[]; a successful entry carries variants[] and SHOULD NOT carry errors.",
                 "items": {
-                  "$ref": "/schemas/3.1.15/core/error.json"
+                  "$ref": "/schemas/3.1.20/core/error.json"
                 },
                 "minItems": 1
               }
@@ -493,7 +493,7 @@
           "description": "Echoes the `keep_mode` the agent applied (mirrors the request hint). Present when the request set `keep_mode`. `keep_mode` is advisory — it does not change what is produced or billed (you pay for every leaf in `variants[]`) — so this echo is the buyer's confirmation that the hint was received, the audit paper trail for a 'I asked for keep_one but was billed for N' dispute. Whether the agent acted on it shows in the `recommended`/`rank` it set on the leaves."
         },
         "selection_strategy_applied": {
-          "$ref": "/schemas/3.1.15/enums/creative-selection-strategy.json",
+          "$ref": "/schemas/3.1.20/enums/creative-selection-strategy.json",
           "x-status": "experimental",
           "description": "Echoes the selection_strategy the agent applied when max_creatives sampling occurred (mirrors keep_mode_applied). Present when the request set selection_strategy. The ranking itself shows in the rank/recommended on creatives[].variants[]."
         },
@@ -510,7 +510,7 @@
           "type": "array",
           "description": "Advisory (non-terminal) entries on an otherwise-successful build — e.g. a `BUDGET_CAP_REACHED` notice when `budget_status` is `capped`. Terminal failures use the BuildCreativeError shape, not this field.",
           "items": {
-            "$ref": "/schemas/3.1.15/core/error.json"
+            "$ref": "/schemas/3.1.20/core/error.json"
           }
         },
         "sandbox": {
@@ -523,10 +523,10 @@
           "description": "ISO 8601 timestamp when the earliest generated asset URL expires across all variants. Re-build after this time to get fresh URLs."
         },
         "context": {
-          "$ref": "/schemas/3.1.15/core/context.json"
+          "$ref": "/schemas/3.1.20/core/context.json"
         },
         "ext": {
-          "$ref": "/schemas/3.1.15/core/ext.json"
+          "$ref": "/schemas/3.1.20/core/ext.json"
         }
       },
       "required": [
@@ -655,7 +655,7 @@
                     "minimum": 0
                   },
                   "consumption_estimate": {
-                    "$ref": "/schemas/3.1.15/core/creative-consumption.json"
+                    "$ref": "/schemas/3.1.20/core/creative-consumption.json"
                   }
                 },
                 "additionalProperties": true
@@ -676,10 +676,10 @@
           "description": "ISO 8601 timestamp after which this estimate's inputs/prices may no longer hold."
         },
         "context": {
-          "$ref": "/schemas/3.1.15/core/context.json"
+          "$ref": "/schemas/3.1.20/core/context.json"
         },
         "ext": {
-          "$ref": "/schemas/3.1.15/core/ext.json"
+          "$ref": "/schemas/3.1.20/core/ext.json"
         }
       },
       "required": [
@@ -697,15 +697,15 @@
           "type": "array",
           "description": "Array of errors explaining why creative generation failed.\n\n**Per-format attribution on multi-format requests.** When the request used `target_format_ids[]` (a batch request), sellers MUST attribute each failure to the specific format(s) that caused it so buyers can correct and retry the failing subset rather than re-running the entire batch. Two attribution surfaces, populated together:\n\n1. **`error.field`** — set to `target_format_ids[N]` where `N` is the zero-based index of the failing format in the request's `target_format_ids[]` array (e.g., `target_format_ids[1]` for the second requested format). Mirrors the JSONPath-lite convention `error.field` uses elsewhere. Required when the error is format-scoped.\n2. **`error.details.format_id`** — the resolved `format_id` value (e.g., `\"meta-reels-9x16\"`). Required when the error is format-scoped. Lets buyers dispatch on the format identity without re-parsing `error.field`.\n\nErrors not attributable to a specific format (whole-batch failures: authentication, governance denial, transport-level errors) MAY omit `field` and `details.format_id`. Buyers MUST treat per-format errors as scoped to the named format only — a `correctable` error on `target_format_ids[1]` does NOT mean the buyer must reshape the entire batch; they may retry just that format with corrected input. Sellers SHOULD emit one error per failing format (rather than collapsing multiple format failures into a single error entry) so per-format recovery routing is unambiguous.",
           "items": {
-            "$ref": "/schemas/3.1.15/core/error.json"
+            "$ref": "/schemas/3.1.20/core/error.json"
           },
           "minItems": 1
         },
         "context": {
-          "$ref": "/schemas/3.1.15/core/context.json"
+          "$ref": "/schemas/3.1.20/core/context.json"
         },
         "ext": {
-          "$ref": "/schemas/3.1.15/core/ext.json"
+          "$ref": "/schemas/3.1.20/core/ext.json"
         }
       },
       "required": [
@@ -771,14 +771,14 @@
           "type": "array",
           "description": "Optional advisory errors accompanying the submitted envelope. Use only for non-blocking warnings (e.g., throttled_severity advisories, governance observations). Terminal failures belong in the error branch, not here.",
           "items": {
-            "$ref": "/schemas/3.1.15/core/error.json"
+            "$ref": "/schemas/3.1.20/core/error.json"
           }
         },
         "context": {
-          "$ref": "/schemas/3.1.15/core/context.json"
+          "$ref": "/schemas/3.1.20/core/context.json"
         },
         "ext": {
-          "$ref": "/schemas/3.1.15/core/ext.json"
+          "$ref": "/schemas/3.1.20/core/ext.json"
         }
       },
       "required": [

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

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/media-buy/create-media-buy-async-response-input-required.json",
+  "$id": "/schemas/3.1.20/media-buy/create-media-buy-async-response-input-required.json",
   "title": "Create Media Buy - Input Required",
   "description": "Payload when task is paused waiting for user input or approval.",
   "type": "object",
@@ -17,14 +17,14 @@
       "type": "array",
       "description": "Optional validation errors or warnings for debugging purposes. Helps explain why input is required.",
       "items": {
-        "$ref": "/schemas/3.1.15/core/error.json"
+        "$ref": "/schemas/3.1.20/core/error.json"
       }
     },
     "context": {
-      "$ref": "/schemas/3.1.15/core/context.json"
+      "$ref": "/schemas/3.1.20/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.1.15/core/ext.json"
+      "$ref": "/schemas/3.1.20/core/ext.json"
     }
   },
   "additionalProperties": true

package/dist/lib/schemas-data/3.1/media-buy/create-media-buy-async-response-submitted.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/media-buy/create-media-buy-async-response-submitted.json",
+  "$id": "/schemas/3.1.20/media-buy/create-media-buy-async-response-submitted.json",
   "title": "Create Media Buy - Submitted",
   "description": "Async task envelope returned when create_media_buy cannot be confirmed before the response is emitted. The buyer polls tasks/get with task_id or receives a webhook when the task completes; the media_buy_id and packages land on the completion artifact, not this envelope.",
   "type": "object",
@@ -24,14 +24,14 @@
       "type": "array",
       "description": "Optional advisory errors accompanying the submitted envelope. Use only for non-blocking warnings (e.g., throttled_severity advisories, governance observations). Terminal failures belong in the error branch, not here.",
       "items": {
-        "$ref": "/schemas/3.1.15/core/error.json"
+        "$ref": "/schemas/3.1.20/core/error.json"
       }
     },
     "context": {
-      "$ref": "/schemas/3.1.15/core/context.json"
+      "$ref": "/schemas/3.1.20/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.1.15/core/ext.json"
+      "$ref": "/schemas/3.1.20/core/ext.json"
     }
   },
   "required": [

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

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/media-buy/create-media-buy-async-response-working.json",
+  "$id": "/schemas/3.1.20/media-buy/create-media-buy-async-response-working.json",
   "title": "Create Media Buy - Working",
   "description": "Progress payload for active create_media_buy task.",
   "type": "object",
@@ -26,10 +26,10 @@
       "description": "Current step number"
     },
     "context": {
-      "$ref": "/schemas/3.1.15/core/context.json"
+      "$ref": "/schemas/3.1.20/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.1.15/core/ext.json"
+      "$ref": "/schemas/3.1.20/core/ext.json"
     }
   },
   "additionalProperties": true