npm - @adcp/sdk - Versions diffs - 9.6.1 → 9.7.0 - Mend

@adcp/sdk 9.6.1 → 9.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1403) hide show

package/dist/lib/schemas-data/3.1/bundled/creative/validate-input-request.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.0/bundled/creative/validate-input-request.json",
+  "$id": "/schemas/3.1.1/bundled/creative/validate-input-request.json",
   "title": "Validate Input Request",
   "description": "Request payload for the validate_input task. Lets buyers dry-run a creative manifest against canonical formats and/or specific products before committing to a render. Cheaper than preview_creative (no synthesis cost). Used by build_creative internally to validate inputs before producing output. For genuinely nondeterministic generative platforms (Veo/Sora/Runway-class) where predictive validation is impossible, the platform's own post-synthesis QA loop applies — validate_input is the predictable-case primitive.\n\nThe `targets[]` array is a discriminated list of validation targets, mirroring the response shape on `validate-input-result.json#target`. Each entry has a `kind` (canonical | product | third_party_format) plus a kind-specific identifier. Discriminated-by-kind on both sides eliminates a wire-shape mismatch: a previous draft used `format_ids: string[]` for canonical names alongside `product_ids: string[]`, which collided with `Product.format_ids: FormatId[]` ({agent_url, id}) — codegen would emit the same field name with two different types. Discriminated `targets[]` makes the intent explicit and codegen-clean.",
   "type": "object",
@@ -51,7 +51,7 @@
                     "nike",
                     "pampers"
                   ],
-                  "$id": "/schemas/3.1.0/core/brand-id.json"
+                  "$id": "/schemas/3.1.1/core/brand-id.json"
                 },
                 "industries": {
                   "type": "array",
@@ -396,7 +396,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.0/core/ext.json"
+                                            "$id": "/schemas/3.1.1/core/ext.json"
                                           }
                                         },
                                         "additionalProperties": true
@@ -1121,7 +1121,7 @@
               "width"
             ]
           },
-          "$id": "/schemas/3.1.0/core/format-id.json"
+          "$id": "/schemas/3.1.1/core/format-id.json"
         },
         "format_kind": {
           "title": "Canonical Format Kind",
@@ -1142,7 +1142,7 @@
             "agent_placement",
             "custom"
           ],
-          "$id": "/schemas/3.1.0/core/canonical-format-kind.json"
+          "$id": "/schemas/3.1.1/core/canonical-format-kind.json"
         },
         "format_option_ref": {
           "title": "Format Option Reference",
@@ -1203,7 +1203,7 @@
             }
           ],
           "additionalProperties": true,
-          "$id": "/schemas/3.1.0/core/format-option-ref.json"
+          "$id": "/schemas/3.1.1/core/format-option-ref.json"
         },
         "assets": {
           "type": "object",
@@ -1598,7 +1598,8 @@
                     },
                     {
                       "title": "Video Asset",
-                      "description": "Video asset with URL and technical specifications including audio track properties",
+                      "description": "A hosted video file delivered directly (e.g., an MP4 you host), with URL and technical specifications including audio track properties. `width` and `height` are required because a hosted video file has intrinsic, native pixel dimensions that are known when the file is created. Tag-delivered video uses the separate `vast` asset, which carries no `width`/`height`: a VAST response resolves geometry per-`MediaFile` at serve time, so there is no single width/height for the ad. Aspect-ratio and size *constraints* (what a placement accepts) belong on the format/requirements layer, not on the asset.",
+                      "$comment": "Dimension policy is deliberate and differs by asset type: a hosted `video` asset requires width/height (intrinsic pixels of a concrete file), while the `vast` asset omits them entirely (renditions are selected per-MediaFile by the player at serve time). Do not infer that AdCP forces a single width/height onto all video — only onto hosted files.",
                       "type": "object",
                       "properties": {
                         "asset_type": {
@@ -1614,12 +1615,12 @@
                         "width": {
                           "type": "integer",
                           "minimum": 1,
-                          "description": "Width in pixels"
+                          "description": "Width in pixels — the video file's intrinsic native width. Required: a hosted file always has concrete dimensions. (Tag-delivered video carries no width; see the `vast` asset.)"
                         },
                         "height": {
                           "type": "integer",
                           "minimum": 1,
-                          "description": "Height in pixels"
+                          "description": "Height in pixels — the video file's intrinsic native height. Required: a hosted file always has concrete dimensions. (Tag-delivered video carries no height; see the `vast` asset.)"
                         },
                         "duration_ms": {
                           "type": "integer",
@@ -2519,7 +2520,7 @@
                     },
                     {
                       "title": "VAST Asset",
-                      "description": "VAST (Video Ad Serving Template) tag for third-party video ad serving",
+                      "description": "VAST (Video Ad Serving Template) tag for third-party video ad serving. Unlike the hosted `video` asset, a VAST tag carries no `width`/`height`: a VAST response can return multiple renditions of differing dimensions, and the player selects one per device at serve time, so there is no single width/height for the ad. Dimensional, duration, and codec *constraints* for a placement live on the format/requirements layer, not on this asset.",
                       "type": "object",
                       "properties": {
                         "asset_type": {
@@ -6215,7 +6216,7 @@
                                   "role"
                                 ],
                                 "additionalProperties": true,
-                                "$id": "/schemas/3.1.0/core/reference-asset.json"
+                                "$id": "/schemas/3.1.1/core/reference-asset.json"
                               }
                             },
                             "compliance": {
@@ -6530,7 +6531,7 @@
                                     }
                                   }
                                 ],
-                                "$id": "/schemas/3.1.0/core/catalog-field-mapping.json"
+                                "$id": "/schemas/3.1.1/core/catalog-field-mapping.json"
                               },
                               "minItems": 1
                             }
@@ -7507,7 +7508,8 @@
                             },
                             {
                               "title": "Video Asset",
-                              "description": "Video asset with URL and technical specifications including audio track properties",
+                              "description": "A hosted video file delivered directly (e.g., an MP4 you host), with URL and technical specifications including audio track properties. `width` and `height` are required because a hosted video file has intrinsic, native pixel dimensions that are known when the file is created. Tag-delivered video uses the separate `vast` asset, which carries no `width`/`height`: a VAST response resolves geometry per-`MediaFile` at serve time, so there is no single width/height for the ad. Aspect-ratio and size *constraints* (what a placement accepts) belong on the format/requirements layer, not on the asset.",
+                              "$comment": "Dimension policy is deliberate and differs by asset type: a hosted `video` asset requires width/height (intrinsic pixels of a concrete file), while the `vast` asset omits them entirely (renditions are selected per-MediaFile by the player at serve time). Do not infer that AdCP forces a single width/height onto all video — only onto hosted files.",
                               "type": "object",
                               "properties": {
                                 "asset_type": {
@@ -7523,12 +7525,12 @@
                                 "width": {
                                   "type": "integer",
                                   "minimum": 1,
-                                  "description": "Width in pixels"
+                                  "description": "Width in pixels — the video file's intrinsic native width. Required: a hosted file always has concrete dimensions. (Tag-delivered video carries no width; see the `vast` asset.)"
                                 },
                                 "height": {
                                   "type": "integer",
                                   "minimum": 1,
-                                  "description": "Height in pixels"
+                                  "description": "Height in pixels — the video file's intrinsic native height. Required: a hosted file always has concrete dimensions. (Tag-delivered video carries no height; see the `vast` asset.)"
                                 },
                                 "duration_ms": {
                                   "type": "integer",
@@ -8429,7 +8431,7 @@
                                 "digest": "sha256:a3f5b7c9d8e2f1a4b6c8d0e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d6e8f0a2"
                               }
                             ],
-                            "$id": "/schemas/3.1.0/core/platform-extension-ref.json"
+                            "$id": "/schemas/3.1.1/core/platform-extension-ref.json"
                           }
                         },
                         "provenance": {
@@ -10450,7 +10452,8 @@
                       },
                       {
                         "title": "Video Asset",
-                        "description": "Video asset with URL and technical specifications including audio track properties",
+                        "description": "A hosted video file delivered directly (e.g., an MP4 you host), with URL and technical specifications including audio track properties. `width` and `height` are required because a hosted video file has intrinsic, native pixel dimensions that are known when the file is created. Tag-delivered video uses the separate `vast` asset, which carries no `width`/`height`: a VAST response resolves geometry per-`MediaFile` at serve time, so there is no single width/height for the ad. Aspect-ratio and size *constraints* (what a placement accepts) belong on the format/requirements layer, not on the asset.",
+                        "$comment": "Dimension policy is deliberate and differs by asset type: a hosted `video` asset requires width/height (intrinsic pixels of a concrete file), while the `vast` asset omits them entirely (renditions are selected per-MediaFile by the player at serve time). Do not infer that AdCP forces a single width/height onto all video — only onto hosted files.",
                         "type": "object",
                         "properties": {
                           "asset_type": {
@@ -10466,12 +10469,12 @@
                           "width": {
                             "type": "integer",
                             "minimum": 1,
-                            "description": "Width in pixels"
+                            "description": "Width in pixels — the video file's intrinsic native width. Required: a hosted file always has concrete dimensions. (Tag-delivered video carries no width; see the `vast` asset.)"
                           },
                           "height": {
                             "type": "integer",
                             "minimum": 1,
-                            "description": "Height in pixels"
+                            "description": "Height in pixels — the video file's intrinsic native height. Required: a hosted file always has concrete dimensions. (Tag-delivered video carries no height; see the `vast` asset.)"
                           },
                           "duration_ms": {
                             "type": "integer",
@@ -11371,7 +11374,7 @@
                       },
                       {
                         "title": "VAST Asset",
-                        "description": "VAST (Video Ad Serving Template) tag for third-party video ad serving",
+                        "description": "VAST (Video Ad Serving Template) tag for third-party video ad serving. Unlike the hosted `video` asset, a VAST tag carries no `width`/`height`: a VAST response can return multiple renditions of differing dimensions, and the player selects one per device at serve time, so there is no single width/height for the ad. Dimensional, duration, and codec *constraints* for a placement live on the format/requirements layer, not on this asset.",
                         "type": "object",
                         "properties": {
                           "asset_type": {
@@ -16357,7 +16360,8 @@
                               },
                               {
                                 "title": "Video Asset",
-                                "description": "Video asset with URL and technical specifications including audio track properties",
+                                "description": "A hosted video file delivered directly (e.g., an MP4 you host), with URL and technical specifications including audio track properties. `width` and `height` are required because a hosted video file has intrinsic, native pixel dimensions that are known when the file is created. Tag-delivered video uses the separate `vast` asset, which carries no `width`/`height`: a VAST response resolves geometry per-`MediaFile` at serve time, so there is no single width/height for the ad. Aspect-ratio and size *constraints* (what a placement accepts) belong on the format/requirements layer, not on the asset.",
+                                "$comment": "Dimension policy is deliberate and differs by asset type: a hosted `video` asset requires width/height (intrinsic pixels of a concrete file), while the `vast` asset omits them entirely (renditions are selected per-MediaFile by the player at serve time). Do not infer that AdCP forces a single width/height onto all video — only onto hosted files.",
                                 "type": "object",
                                 "properties": {
                                   "asset_type": {
@@ -16373,12 +16377,12 @@
                                   "width": {
                                     "type": "integer",
                                     "minimum": 1,
-                                    "description": "Width in pixels"
+                                    "description": "Width in pixels — the video file's intrinsic native width. Required: a hosted file always has concrete dimensions. (Tag-delivered video carries no width; see the `vast` asset.)"
                                   },
                                   "height": {
                                     "type": "integer",
                                     "minimum": 1,
-                                    "description": "Height in pixels"
+                                    "description": "Height in pixels — the video file's intrinsic native height. Required: a hosted file always has concrete dimensions. (Tag-delivered video carries no height; see the `vast` asset.)"
                                   },
                                   "duration_ms": {
                                     "type": "integer",
@@ -19492,7 +19496,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.0/enums/right-use.json"
+                  "$id": "/schemas/3.1.1/enums/right-use.json"
                 },
                 "minItems": 1
               },
@@ -19536,7 +19540,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.0/enums/right-type.json"
+                "$id": "/schemas/3.1.1/enums/right-type.json"
               },
               "approval_status": {
                 "type": "string",
@@ -19565,7 +19569,7 @@
               "uses"
             ],
             "additionalProperties": true,
-            "$id": "/schemas/3.1.0/core/rights-constraint.json"
+            "$id": "/schemas/3.1.1/core/rights-constraint.json"
           }
         },
         "industry_identifiers": {
@@ -19598,7 +19602,7 @@
                   "clearcast_clock",
                   "idcrea"
                 ],
-                "$id": "/schemas/3.1.0/enums/creative-identifier-type.json"
+                "$id": "/schemas/3.1.1/enums/creative-identifier-type.json"
               },
               "value": {
                 "type": "string",
@@ -19611,7 +19615,7 @@
               "value"
             ],
             "additionalProperties": true,
-            "$id": "/schemas/3.1.0/core/industry-identifier.json"
+            "$id": "/schemas/3.1.1/core/industry-identifier.json"
           },
           "uniqueItems": true
         },
@@ -20135,7 +20139,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.0/enums/digital-source-type.json"
+      "$id": "/schemas/3.1.1/enums/digital-source-type.json"
     },
     "EmbeddedProvenanceMethod": {
       "title": "Embedded Provenance Method",
@@ -20149,7 +20153,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.0/enums/embedded-provenance-method.json"
+      "$id": "/schemas/3.1.1/enums/embedded-provenance-method.json"
     },
     "WatermarkMediaType": {
       "title": "Watermark Media Type",
@@ -20167,7 +20171,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.0/enums/watermark-media-type.json"
+      "$id": "/schemas/3.1.1/enums/watermark-media-type.json"
     },
     "C2PAWatermarkAction": {
       "title": "C2PA Watermark Action",
@@ -20181,7 +20185,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.0/enums/c2pa-watermark-action.json"
+      "$id": "/schemas/3.1.1/enums/c2pa-watermark-action.json"
     },
     "DisclosurePersistence": {
       "title": "Disclosure Persistence",
@@ -20197,7 +20201,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.0/enums/disclosure-persistence.json"
+      "$id": "/schemas/3.1.1/enums/disclosure-persistence.json"
     },
     "DisclosurePosition": {
       "title": "Disclosure Position",
@@ -20213,7 +20217,7 @@
         "pre_roll",
         "companion"
       ],
-      "$id": "/schemas/3.1.0/enums/disclosure-position.json"
+      "$id": "/schemas/3.1.1/enums/disclosure-position.json"
     },
     "FrameRateType": {
       "title": "Frame Rate Type",
@@ -20227,7 +20231,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.0/enums/frame-rate-type.json"
+      "$id": "/schemas/3.1.1/enums/frame-rate-type.json"
     },
     "ScanType": {
       "title": "Scan Type",
@@ -20241,7 +20245,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.0/enums/scan-type.json"
+      "$id": "/schemas/3.1.1/enums/scan-type.json"
     },
     "GOPType": {
       "title": "GOP Type",
@@ -20255,7 +20259,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.0/enums/gop-type.json"
+      "$id": "/schemas/3.1.1/enums/gop-type.json"
     },
     "MoovAtomPosition": {
       "title": "Moov Atom Position",
@@ -20269,7 +20273,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.0/enums/moov-atom-position.json"
+      "$id": "/schemas/3.1.1/enums/moov-atom-position.json"
     },
     "AudioChannelLayout": {
       "title": "Audio Channel Layout",
@@ -20281,7 +20285,7 @@
         "5.1",
         "7.1"
       ],
-      "$id": "/schemas/3.1.0/enums/audio-channel-layout.json"
+      "$id": "/schemas/3.1.1/enums/audio-channel-layout.json"
     },
     "VASTVersion": {
       "title": "VAST Version",
@@ -20294,7 +20298,7 @@
         "4.1",
         "4.2"
       ],
-      "$id": "/schemas/3.1.0/enums/vast-version.json"
+      "$id": "/schemas/3.1.1/enums/vast-version.json"
     },
     "VASTTrackingEvent": {
       "title": "VAST Tracking Event",
@@ -20338,7 +20342,7 @@
         "measurableImpression",
         "viewableImpression"
       ],
-      "$id": "/schemas/3.1.0/enums/vast-tracking-event.json"
+      "$id": "/schemas/3.1.1/enums/vast-tracking-event.json"
     },
     "URLAssetType": {
       "title": "URL Asset Type",
@@ -20349,7 +20353,7 @@
         "tracker_pixel",
         "tracker_script"
       ],
-      "$id": "/schemas/3.1.0/enums/url-asset-type.json"
+      "$id": "/schemas/3.1.1/enums/url-asset-type.json"
     },
     "JavaScriptModuleType": {
       "title": "JavaScript Module Type",
@@ -20360,7 +20364,7 @@
         "commonjs",
         "script"
       ],
-      "$id": "/schemas/3.1.0/enums/javascript-module-type.json"
+      "$id": "/schemas/3.1.1/enums/javascript-module-type.json"
     },
     "HTTPMethod": {
       "title": "HTTP Method",
@@ -20370,7 +20374,7 @@
         "GET",
         "POST"
       ],
-      "$id": "/schemas/3.1.0/enums/http-method.json",
+      "$id": "/schemas/3.1.1/enums/http-method.json",
       "default": "POST"
     },
     "UniversalMacro": {
@@ -20531,7 +20535,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.0/enums/universal-macro.json"
+      "$id": "/schemas/3.1.1/enums/universal-macro.json"
     },
     "WebhookResponseType": {
       "title": "Webhook Response Type",
@@ -20543,7 +20547,7 @@
         "xml",
         "javascript"
       ],
-      "$id": "/schemas/3.1.0/enums/webhook-response-type.json"
+      "$id": "/schemas/3.1.1/enums/webhook-response-type.json"
     },
     "WebhookSecurityMethod": {
       "title": "Webhook Security Method",
@@ -20554,7 +20558,7 @@
         "api_key",
         "none"
       ],
-      "$id": "/schemas/3.1.0/enums/webhook-security-method.json"
+      "$id": "/schemas/3.1.1/enums/webhook-security-method.json"
     },
     "DAASTVersion": {
       "title": "DAAST Version",
@@ -20564,7 +20568,7 @@
         "1.0",
         "1.1"
       ],
-      "$id": "/schemas/3.1.0/enums/daast-version.json"
+      "$id": "/schemas/3.1.1/enums/daast-version.json"
     },
     "DAASTTrackingEvent": {
       "title": "DAAST Tracking Event",
@@ -20595,7 +20599,7 @@
         "measurableImpression",
         "viewableImpression"
       ],
-      "$id": "/schemas/3.1.0/enums/daast-tracking-event.json"
+      "$id": "/schemas/3.1.1/enums/daast-tracking-event.json"
     },
     "MarkdownFlavor": {
       "title": "Markdown Flavor",
@@ -20605,7 +20609,7 @@
         "commonmark",
         "gfm"
       ],
-      "$id": "/schemas/3.1.0/enums/markdown-flavor.json",
+      "$id": "/schemas/3.1.1/enums/markdown-flavor.json",
       "default": "commonmark"
     },
     "CatalogType": {
@@ -20627,7 +20631,7 @@
         "destination",
         "app"
       ],
-      "$id": "/schemas/3.1.0/enums/catalog-type.json"
+      "$id": "/schemas/3.1.1/enums/catalog-type.json"
     },
     "FeedFormat": {
       "title": "Feed Format",
@@ -20653,7 +20657,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.0/enums/feed-format.json"
+      "$id": "/schemas/3.1.1/enums/feed-format.json"
     },
     "UpdateFrequency": {
       "title": "Update Frequency",
@@ -20665,7 +20669,7 @@
         "daily",
         "weekly"
       ],
-      "$id": "/schemas/3.1.0/enums/update-frequency.json"
+      "$id": "/schemas/3.1.1/enums/update-frequency.json"
     },
     "EventType": {
       "title": "Event Type",
@@ -20737,7 +20741,7 @@
         "submit_application": "User submitted an application (loan, job, etc.)",
         "custom": "Custom event type (specify in custom_event_name)"
       },
-      "$id": "/schemas/3.1.0/enums/event-type.json"
+      "$id": "/schemas/3.1.1/enums/event-type.json"
     },
     "ContentIDType": {
       "title": "Content ID Type",
@@ -20757,11 +20761,11 @@
         "destination_id",
         "app_id"
       ],
-      "$id": "/schemas/3.1.0/enums/content-id-type.json"
+      "$id": "/schemas/3.1.1/enums/content-id-type.json"
     }
   },
   "_bundled": {
-    "generatedAt": "2026-06-18T08:17:00.595Z",
+    "generatedAt": "2026-06-30T19:14:39.961Z",
     "note": "This is a bundled schema with all $ref resolved inline. For the modular version with references, use the parent directory."
   }
 }

package/dist/lib/schemas-data/3.1/bundled/creative/validate-input-response.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.0/bundled/creative/validate-input-response.json",
+  "$id": "/schemas/3.1.1/bundled/creative/validate-input-response.json",
   "title": "Validate Input Response",
   "description": "Response payload for the validate_input task. Returns per-target validation results — one entry per format_id or product_id requested. Each result carries a `result_kind` discriminator (`validated_pass` / `validated_fail` / `unvalidatable_nondeterministic`) so callers can branch on three meaningfully different outcomes. The `predicted` field on violations carries the platform's pre-flight estimate (e.g., predicted audio duration from text-length analysis), NOT the actual output — there is no protocol state for orphaned out-of-spec artifacts. For nondeterministic generative platforms (Veo / Sora / Runway-class with `synthesis_nondeterministic: true`), the result_kind is `unvalidatable_nondeterministic` — predictive validation is impossible, the platform's post-synthesis QA loop applies on `build_creative`, and out-of-spec output never reaches this surface (instead `build_creative` returns task_failed with synthesis_failed reason).\n\nThe `ValidateInputResult` type is split into its own schema (`/schemas/creative/validate-input-result.json`) rather than inlined here because the same per-target shape is intended for reuse by adjacent async-validation surfaces (planned: per-batch result envelopes on `build_creative` async paths, and asynchronous canonical-against-product validation in `sync_creatives`). Producers that only need the synchronous batch shape today MAY treat the split as YAGNI, but the schema reuse anchors the violation/retry shape so downstream surfaces don't drift.",
   "type": "object",
@@ -168,7 +168,7 @@
             }
           }
         ],
-        "$id": "/schemas/3.1.0/creative/validate-input-result.json"
+        "$id": "/schemas/3.1.1/creative/validate-input-result.json"
       },
       "description": "Per-target validation results."
     }
@@ -198,7 +198,7 @@
           "maximum": 99
         }
       },
-      "$id": "/schemas/3.1.0/core/version-envelope.json"
+      "$id": "/schemas/3.1.1/core/version-envelope.json"
     },
     {
       "title": "Protocol Envelope",
@@ -214,7 +214,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.0/core/context.json"
+          "$id": "/schemas/3.1.1/core/context.json"
         },
         "task_id": {
           "type": "string",
@@ -247,7 +247,7 @@
             "auth-required": "Task requires authentication to proceed",
             "unknown": "Task is in an unknown or indeterminate state"
           },
-          "$id": "/schemas/3.1.0/enums/task-status.json"
+          "$id": "/schemas/3.1.1/enums/task-status.json"
         },
         "message": {
           "type": "string",
@@ -386,7 +386,7 @@
             "message"
           ],
           "additionalProperties": true,
-          "$id": "/schemas/3.1.0/core/error.json"
+          "$id": "/schemas/3.1.1/core/error.json"
         },
         "push_notification_config": {
           "title": "Push Notification Config",
@@ -426,7 +426,7 @@
                       "Bearer",
                       "HMAC-SHA256"
                     ],
-                    "$id": "/schemas/3.1.0/enums/auth-scheme.json"
+                    "$id": "/schemas/3.1.1/enums/auth-scheme.json"
                   },
                   "minItems": 1,
                   "maxItems": 1
@@ -447,7 +447,7 @@
           "required": [
             "url"
           ],
-          "$id": "/schemas/3.1.0/core/push-notification-config.json"
+          "$id": "/schemas/3.1.1/core/push-notification-config.json"
         },
         "governance_context": {
           "type": "string",
@@ -597,11 +597,11 @@
         "`status` is REQUIRED on the conceptual envelope across all transports. On MCP and REST it appears as a sibling field at the JSON root (or `structuredContent` root for MCP); on A2A the canonical carrier is `task.status.state`, which maps 1:1 to this `status` value — receivers MUST extract A2A's `task.status.state` into the in-memory envelope `status` per the canonical extraction algorithm. The schema-level `required: [status]` enforces the post-extraction in-memory shape; the transport-native form satisfies the requirement on each wire. `payload` remains intentionally NOT required — it is a documentary grouping construct, never a required wire field. See `mcp-guide.mdx` and `a2a-guide.mdx` for the wire-level patterns receivers MUST implement.",
         "Receivers MUST handle absence of an envelope field (e.g., `replayed` omitted) as the field's documented default — see each field's `default` clause."
       ],
-      "$id": "/schemas/3.1.0/core/protocol-envelope.json"
+      "$id": "/schemas/3.1.1/core/protocol-envelope.json"
     }
   ],
   "_bundled": {
-    "generatedAt": "2026-06-18T08:17:00.602Z",
+    "generatedAt": "2026-06-30T19:14:39.972Z",
     "note": "This is a bundled schema with all $ref resolved inline. For the modular version with references, use the parent directory."
   }
 }