@adcp/sdk 13.0.1 → 13.0.3

package/dist/lib/schemas-data/3.1/bundled/signals/get-signals-response.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/bundled/signals/get-signals-response.json",
+  "$id": "/schemas/3.1.20/bundled/signals/get-signals-response.json",
   "title": "Get Signals Response",
   "description": "Response payload for get_signals task",
   "type": "object",
@@ -28,7 +28,7 @@
           "maximum": 99
         }
       },
-      "$id": "/schemas/3.1.15/core/version-envelope.json"
+      "$id": "/schemas/3.1.20/core/version-envelope.json"
     },
     {
       "title": "Protocol Envelope",
@@ -44,7 +44,7 @@
           "description": "Per-request opaque caller-supplied correlation object echoed unchanged in the response. Used for buyer-side tracking (UI session IDs, trace IDs, custom metadata) that the agent MUST preserve byte-for-byte without parsing. Distinct from `context_id` (server-managed session identifier) — `context` is caller-owned echo, `context_id` is server-owned session scope. Both MAY appear on the same response.\n\n**Relationship to per-task body-level `context` declarations.** Many task request/response schemas (147 as of 3.1) already declare a body-level `context` field that `$ref`s `/schemas/core/context.json` at the body root. Under the flat-on-the-wire MCP serialization (see `notes` below), envelope-level `context` and body-level `context` occupy the same key on the response root — they are NOT separate fields, they MUST share the same value, and they MUST both `$ref` `core/context.json`. The envelope declaration is **authoritative** for the schema definition; per-task body declarations are mirrors retained for tooling reasons (SDK codegen completeness, per-task validation against the response schema in isolation). Future versions MAY drop body-level `context` declarations from per-task schemas; conformance does not require either declaration to be present, only that the wire value `$ref`s `core/context.json`.",
           "type": "object",
           "additionalProperties": true,
-          "$id": "/schemas/3.1.15/core/context.json"
+          "$id": "/schemas/3.1.20/core/context.json"
         },
         "task_id": {
           "type": "string",
@@ -77,7 +77,7 @@
             "auth-required": "Task requires authentication to proceed",
             "unknown": "Task is in an unknown or indeterminate state"
           },
-          "$id": "/schemas/3.1.15/enums/task-status.json"
+          "$id": "/schemas/3.1.20/enums/task-status.json"
         },
         "message": {
           "type": "string",
@@ -216,7 +216,7 @@
             "message"
           ],
           "additionalProperties": true,
-          "$id": "/schemas/3.1.15/core/error.json"
+          "$id": "/schemas/3.1.20/core/error.json"
         },
         "push_notification_config": {
           "title": "Push Notification Config",
@@ -256,7 +256,7 @@
                       "Bearer",
                       "HMAC-SHA256"
                     ],
-                    "$id": "/schemas/3.1.15/enums/auth-scheme.json"
+                    "$id": "/schemas/3.1.20/enums/auth-scheme.json"
                   },
                   "minItems": 1,
                   "maxItems": 1
@@ -277,7 +277,7 @@
           "required": [
             "url"
           ],
-          "$id": "/schemas/3.1.15/core/push-notification-config.json"
+          "$id": "/schemas/3.1.20/core/push-notification-config.json"
         },
         "governance_context": {
           "type": "string",
@@ -427,7 +427,7 @@
         "`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.15/core/protocol-envelope.json"
+      "$id": "/schemas/3.1.20/core/protocol-envelope.json"
     }
   ],
   "properties": {
@@ -603,7 +603,7 @@
                     "additionalProperties": true
                   }
                 ],
-                "$id": "/schemas/3.1.15/core/signal-ref.json"
+                "$id": "/schemas/3.1.20/core/signal-ref.json"
               },
               "signal_id": {
                 "title": "Signal ID",
@@ -669,7 +669,7 @@
                     "additionalProperties": true
                   }
                 ],
-                "$id": "/schemas/3.1.15/core/signal-id.json"
+                "$id": "/schemas/3.1.20/core/signal-id.json"
               },
               "name": {
                 "type": "string",
@@ -799,7 +799,7 @@
                     "age": "A person's age or age range. US ADEA (40+) for employment, US FHA for housing, EU AVMSD for content-directed targeting. Restricted for regulated verticals.",
                     "familial_status": "Whether a household includes children under 18, a pregnant person, or a person seeking custody of a minor. US FHA protected class."
                   },
-                  "$id": "/schemas/3.1.15/enums/restricted-attribute.json"
+                  "$id": "/schemas/3.1.20/enums/restricted-attribute.json"
                 },
                 "minItems": 1
               },
@@ -1039,7 +1039,7 @@
                     "contract",
                     "legal_obligation"
                   ],
-                  "$id": "/schemas/3.1.15/enums/consent-basis.json"
+                  "$id": "/schemas/3.1.20/enums/consent-basis.json"
                 },
                 "description": "Data provider's declared GDPR Article 6 lawful basis or consent basis for the underlying signal definition, projected into this get_signals response row when requested. Sellers and federating agents that pass through another provider's signal MUST NOT substitute their own processing basis for the provider-declared basis."
               },
@@ -1190,7 +1190,7 @@
                       }
                     ],
                     "additionalProperties": false,
-                    "$id": "/schemas/3.1.15/core/signal-modeling-disclosure.json"
+                    "$id": "/schemas/3.1.20/core/signal-modeling-disclosure.json"
                   }
                 },
                 "required": [
@@ -1316,7 +1316,7 @@
               }
             },
             "additionalProperties": true,
-            "$id": "/schemas/3.1.15/core/signal-definition-enrichment.json"
+            "$id": "/schemas/3.1.20/core/signal-definition-enrichment.json"
           }
         ],
         "properties": {
@@ -1603,7 +1603,7 @@
               "custom": "Source-native segment built on demand from models, composites, or buyer inputs - not attributable to a standing upstream provider",
               "owned": "First-party segments derived from data the signal agent or seller directly owns (retailer purchase data, publisher behavioral data, telco data)"
             },
-            "$id": "/schemas/3.1.15/enums/signal-catalog-type.json"
+            "$id": "/schemas/3.1.20/enums/signal-catalog-type.json"
           },
           "data_provider": {
             "type": "string",
@@ -1694,7 +1694,7 @@
                                       "metro",
                                       "postal_area"
                                     ],
-                                    "$id": "/schemas/3.1.15/enums/geo-level.json"
+                                    "$id": "/schemas/3.1.20/enums/geo-level.json"
                                   },
                                   "system": {
                                     "type": "string",
@@ -1814,7 +1814,7 @@
                                             "eurostat_nuts2",
                                             "custom"
                                           ],
-                                          "$id": "/schemas/3.1.15/enums/metro-system.json"
+                                          "$id": "/schemas/3.1.20/enums/metro-system.json"
                                         }
                                       },
                                       "required": [
@@ -1879,7 +1879,7 @@
                                                 "ch_plz",
                                                 "at_plz"
                                               ],
-                                              "$id": "/schemas/3.1.15/enums/postal-system.json"
+                                              "$id": "/schemas/3.1.20/enums/postal-system.json"
                                             }
                                           },
                                           "required": [
@@ -2018,7 +2018,7 @@
                                               }
                                             }
                                           ],
-                                          "$id": "/schemas/3.1.15/core/postal-country-system.json"
+                                          "$id": "/schemas/3.1.20/core/postal-country-system.json"
                                         },
                                         {
                                           "properties": {
@@ -2040,7 +2040,7 @@
                                                 "ch_plz",
                                                 "at_plz"
                                               ],
-                                              "$id": "/schemas/3.1.15/enums/legacy-postal-system.json"
+                                              "$id": "/schemas/3.1.20/enums/legacy-postal-system.json"
                                             }
                                           },
                                           "required": [
@@ -2057,7 +2057,7 @@
                                   }
                                 ],
                                 "additionalProperties": false,
-                                "$id": "/schemas/3.1.15/core/forecast-dimension-geo.json"
+                                "$id": "/schemas/3.1.20/core/forecast-dimension-geo.json"
                               },
                               {
                                 "title": "Placement Forecast Dimension",
@@ -2089,7 +2089,7 @@
                                       "placement_id"
                                     ],
                                     "additionalProperties": true,
-                                    "$id": "/schemas/3.1.15/core/placement-ref.json"
+                                    "$id": "/schemas/3.1.20/core/placement-ref.json"
                                   },
                                   "placement_name": {
                                     "type": "string",
@@ -2101,7 +2101,7 @@
                                   "placement_ref"
                                 ],
                                 "additionalProperties": false,
-                                "$id": "/schemas/3.1.15/core/forecast-dimension-placement.json"
+                                "$id": "/schemas/3.1.20/core/forecast-dimension-placement.json"
                               },
                               {
                                 "title": "Device Type Forecast Dimension",
@@ -2125,7 +2125,7 @@
                                       "dooh",
                                       "unknown"
                                     ],
-                                    "$id": "/schemas/3.1.15/enums/device-type.json"
+                                    "$id": "/schemas/3.1.20/enums/device-type.json"
                                   }
                                 },
                                 "required": [
@@ -2133,7 +2133,7 @@
                                   "device_type"
                                 ],
                                 "additionalProperties": false,
-                                "$id": "/schemas/3.1.15/core/forecast-dimension-device-type.json"
+                                "$id": "/schemas/3.1.20/core/forecast-dimension-device-type.json"
                               },
                               {
                                 "title": "Device Platform Forecast Dimension",
@@ -2163,7 +2163,7 @@
                                       "roku_os",
                                       "unknown"
                                     ],
-                                    "$id": "/schemas/3.1.15/enums/device-platform.json"
+                                    "$id": "/schemas/3.1.20/enums/device-platform.json"
                                   }
                                 },
                                 "required": [
@@ -2171,7 +2171,7 @@
                                   "device_platform"
                                 ],
                                 "additionalProperties": false,
-                                "$id": "/schemas/3.1.15/core/forecast-dimension-device-platform.json"
+                                "$id": "/schemas/3.1.20/core/forecast-dimension-device-platform.json"
                               },
                               {
                                 "title": "Audience Forecast Dimension",
@@ -2200,7 +2200,7 @@
                                       "retargeting",
                                       "unknown"
                                     ],
-                                    "$id": "/schemas/3.1.15/enums/audience-source.json"
+                                    "$id": "/schemas/3.1.20/enums/audience-source.json"
                                   },
                                   "audience_name": {
                                     "type": "string",
@@ -2213,7 +2213,7 @@
                                   "audience_source"
                                 ],
                                 "additionalProperties": false,
-                                "$id": "/schemas/3.1.15/core/forecast-dimension-audience.json"
+                                "$id": "/schemas/3.1.20/core/forecast-dimension-audience.json"
                               },
                               {
                                 "title": "Signal Forecast Dimension",
@@ -2483,11 +2483,11 @@
                                   }
                                 ],
                                 "additionalProperties": false,
-                                "$id": "/schemas/3.1.15/core/forecast-dimension-signal.json"
+                                "$id": "/schemas/3.1.20/core/forecast-dimension-signal.json"
                               }
                             ]
                           },
-                          "$id": "/schemas/3.1.15/core/forecast-point-dimensions.json"
+                          "$id": "/schemas/3.1.20/core/forecast-point-dimensions.json"
                         },
                         "metrics": {
                           "type": "object",
@@ -2528,7 +2528,7 @@
                                 }
                               ],
                               "additionalProperties": true,
-                              "$id": "/schemas/3.1.15/core/forecast-range.json"
+                              "$id": "/schemas/3.1.20/core/forecast-range.json"
                             },
                             "reach": {
                               "title": "Forecast Range",
@@ -3189,7 +3189,7 @@
                                     "nike",
                                     "pampers"
                                   ],
-                                  "$id": "/schemas/3.1.15/core/brand-id.json"
+                                  "$id": "/schemas/3.1.20/core/brand-id.json"
                                 },
                                 "industries": {
                                   "type": "array",
@@ -3534,7 +3534,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.15/core/ext.json"
+                                                            "$id": "/schemas/3.1.20/core/ext.json"
                                                           }
                                                         },
                                                         "additionalProperties": true
@@ -3840,7 +3840,7 @@
                                 "mrc": "MRC/IAB standard: 50% of pixels in view for 1 continuous second (display) or 2 continuous seconds (video).",
                                 "groupm": "GroupM standard: 100% of pixels in view for 1 continuous second (display) or 50% of video duration."
                               },
-                              "$id": "/schemas/3.1.15/enums/viewability-standard.json"
+                              "$id": "/schemas/3.1.20/enums/viewability-standard.json"
                             }
                           },
                           "additionalProperties": true,
@@ -4399,7 +4399,7 @@
                                   "co_view_index",
                                   "incremental_lift_percent"
                                 ],
-                                "$id": "/schemas/3.1.15/core/vendor-metric-id.json"
+                                "$id": "/schemas/3.1.20/core/vendor-metric-id.json"
                               },
                               "value": {
                                 "title": "Forecast Range",
@@ -4571,7 +4571,7 @@
                   "modeled": "Forecast derived from platform-specific predictive models or historical data. Publisher uses this to set expectations but does not guarantee delivery.",
                   "guaranteed": "Contractually committed delivery levels backed by reserved inventory"
                 },
-                "$id": "/schemas/3.1.15/enums/forecast-method.json"
+                "$id": "/schemas/3.1.20/enums/forecast-method.json"
               },
               "scope": {
                 "type": "object",
@@ -4636,7 +4636,7 @@
                       "end"
                     ],
                     "additionalProperties": true,
-                    "$id": "/schemas/3.1.15/core/date-range.json"
+                    "$id": "/schemas/3.1.20/core/date-range.json"
                   }
                 },
                 "required": [
@@ -4799,7 +4799,7 @@
                           "additionalProperties": true
                         }
                       ],
-                      "$id": "/schemas/3.1.15/core/activation-key.json"
+                      "$id": "/schemas/3.1.20/core/activation-key.json"
                     },
                     "estimated_activation_duration_minutes": {
                       "type": "number",
@@ -4910,7 +4910,7 @@
                   "additionalProperties": true
                 }
               ],
-              "$id": "/schemas/3.1.15/core/deployment.json"
+              "$id": "/schemas/3.1.20/core/deployment.json"
             }
           },
           "pricing_options": {
@@ -4976,7 +4976,7 @@
                             "width"
                           ]
                         },
-                        "$id": "/schemas/3.1.15/core/format-id.json"
+                        "$id": "/schemas/3.1.20/core/format-id.json"
                       },
                       "minItems": 1
                     }
@@ -5194,10 +5194,10 @@
                       "additionalProperties": true
                     }
                   ],
-                  "$id": "/schemas/3.1.15/core/signal-pricing.json"
+                  "$id": "/schemas/3.1.20/core/signal-pricing.json"
                 }
               ],
-              "$id": "/schemas/3.1.15/core/vendor-pricing-option.json"
+              "$id": "/schemas/3.1.20/core/vendor-pricing-option.json"
             },
             "minItems": 1
           }
@@ -5401,7 +5401,7 @@
                   "unit"
                 ],
                 "additionalProperties": false,
-                "$id": "/schemas/3.1.15/core/duration.json"
+                "$id": "/schemas/3.1.20/core/duration.json"
               }
             ],
             "description": "How much additional time would resolve this scope. Allows the caller to decide whether to retry with a larger time_budget."
@@ -5468,7 +5468,7 @@
         "has_more"
       ],
       "additionalProperties": false,
-      "$id": "/schemas/3.1.15/core/pagination-response.json"
+      "$id": "/schemas/3.1.20/core/pagination-response.json"
     },
     "sandbox": {
       "type": "boolean",
@@ -5550,7 +5550,7 @@
         "categorical": "Signal with discrete values from a defined set (e.g., 'vehicle_ownership' with values 'tesla', 'bmw', etc.)",
         "numeric": "Signal with continuous numeric values within a range (e.g., 'purchase_propensity' from 0.0 to 1.0)"
       },
-      "$id": "/schemas/3.1.15/enums/signal-value-type.json"
+      "$id": "/schemas/3.1.20/enums/signal-value-type.json"
     },
     "DigitalSourceType": {
       "title": "Digital Source Type",
@@ -5578,7 +5578,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.15/enums/digital-source-type.json"
+      "$id": "/schemas/3.1.20/enums/digital-source-type.json"
     },
     "EmbeddedProvenanceMethod": {
       "title": "Embedded Provenance Method",
@@ -5592,7 +5592,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.15/enums/embedded-provenance-method.json"
+      "$id": "/schemas/3.1.20/enums/embedded-provenance-method.json"
     },
     "WatermarkMediaType": {
       "title": "Watermark Media Type",
@@ -5610,7 +5610,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.15/enums/watermark-media-type.json"
+      "$id": "/schemas/3.1.20/enums/watermark-media-type.json"
     },
     "C2PAWatermarkAction": {
       "title": "C2PA Watermark Action",
@@ -5624,7 +5624,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.15/enums/c2pa-watermark-action.json"
+      "$id": "/schemas/3.1.20/enums/c2pa-watermark-action.json"
     },
     "DisclosurePersistence": {
       "title": "Disclosure Persistence",
@@ -5640,7 +5640,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.15/enums/disclosure-persistence.json"
+      "$id": "/schemas/3.1.20/enums/disclosure-persistence.json"
     },
     "DisclosurePosition": {
       "title": "Disclosure Position",
@@ -5656,11 +5656,11 @@
         "pre_roll",
         "companion"
       ],
-      "$id": "/schemas/3.1.15/enums/disclosure-position.json"
+      "$id": "/schemas/3.1.20/enums/disclosure-position.json"
     }
   },
   "_bundled": {
-    "generatedAt": "2026-08-16T19:12:17.885Z",
+    "generatedAt": "2026-09-02T12:43:40.612Z",
     "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/sponsored-intelligence/si-get-offering-request.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.15/bundled/sponsored-intelligence/si-get-offering-request.json",
+  "$id": "/schemas/3.1.20/bundled/sponsored-intelligence/si-get-offering-request.json",
   "title": "SI Get Offering Request",
   "description": "Get offering details and availability before session handoff. Returns offering information, availability status, and optionally matching products based on context.",
   "type": "object",
@@ -28,7 +28,7 @@
           "maximum": 99
         }
       },
-      "$id": "/schemas/3.1.15/core/version-envelope.json"
+      "$id": "/schemas/3.1.20/core/version-envelope.json"
     }
   ],
   "x-status": "experimental",
@@ -47,7 +47,7 @@
       "description": "Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.",
       "type": "object",
       "additionalProperties": true,
-      "$id": "/schemas/3.1.15/core/context.json"
+      "$id": "/schemas/3.1.20/core/context.json"
     },
     "include_products": {
       "type": "boolean",
@@ -66,7 +66,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.15/core/ext.json"
+      "$id": "/schemas/3.1.20/core/ext.json"
     }
   },
   "required": [
@@ -74,7 +74,7 @@
   ],
   "additionalProperties": true,
   "_bundled": {
-    "generatedAt": "2026-08-16T19:12:17.888Z",
+    "generatedAt": "2026-09-02T12:43:40.614Z",
     "note": "This is a bundled schema with all $ref resolved inline. For the modular version with references, use the parent directory."
   }
 }