@adcp/sdk 5.23.0

package/dist/lib/schemas-data/3.0.1/core/creative-manifest.json

@@ -0,0 +1,96 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/schemas/3.0.1/core/creative-manifest.json",
+  "title": "Creative Manifest",
+  "description": "Complete specification of a creative: format_id + assets. Everything the creative needs — images, text, briefs, catalogs — lives in the assets map, declared by the format. Each asset is typed according to its asset_type from the format specification.",
+  "type": "object",
+  "properties": {
+    "format_id": {
+      "$ref": "/schemas/3.0.1/core/format-id.json",
+      "description": "Always a structured object {agent_url, id} — never a plain string. Format identifier this manifest is for. Can be a template format (id only) or a deterministic format (id + dimensions/duration). For dimension-specific creatives, include width/height in the format_id to create a unique identifier (e.g., {id: 'display_static', width: 300, height: 250})."
+    },
+    "assets": {
+      "type": "object",
+      "description": "Map of asset IDs to actual asset content. Each key MUST match an asset_id from the format's assets array (e.g., 'banner_image', 'clickthrough_url', 'video_file', 'vast_tag'). The asset_id is the technical identifier used to match assets to format requirements.\n\nEach asset value carries an `asset_type` discriminator (image, video, audio, vast, daast, text, markdown, url, html, css, webhook, javascript, brief, catalog) that selects the matching asset schema. Validators with OpenAPI-style discriminator support use `asset_type` to report errors against only the selected branch instead of all branches.",
+      "patternProperties": {
+        "^[a-z0-9_]+$": {
+          "oneOf": [
+            {
+              "$ref": "/schemas/3.0.1/core/assets/image-asset.json"
+            },
+            {
+              "$ref": "/schemas/3.0.1/core/assets/video-asset.json"
+            },
+            {
+              "$ref": "/schemas/3.0.1/core/assets/audio-asset.json"
+            },
+            {
+              "$ref": "/schemas/3.0.1/core/assets/vast-asset.json"
+            },
+            {
+              "$ref": "/schemas/3.0.1/core/assets/text-asset.json"
+            },
+            {
+              "$ref": "/schemas/3.0.1/core/assets/url-asset.json"
+            },
+            {
+              "$ref": "/schemas/3.0.1/core/assets/html-asset.json"
+            },
+            {
+              "$ref": "/schemas/3.0.1/core/assets/javascript-asset.json"
+            },
+            {
+              "$ref": "/schemas/3.0.1/core/assets/webhook-asset.json"
+            },
+            {
+              "$ref": "/schemas/3.0.1/core/assets/css-asset.json"
+            },
+            {
+              "$ref": "/schemas/3.0.1/core/assets/daast-asset.json"
+            },
+            {
+              "$ref": "/schemas/3.0.1/core/assets/markdown-asset.json"
+            },
+            {
+              "$ref": "/schemas/3.0.1/core/assets/brief-asset.json"
+            },
+            {
+              "$ref": "/schemas/3.0.1/core/assets/catalog-asset.json"
+            }
+          ],
+          "discriminator": {
+            "propertyName": "asset_type"
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "rights": {
+      "type": "array",
+      "description": "Rights constraints attached to this creative. Each entry represents constraints from a single rights holder. A creative may combine multiple rights constraints (e.g., talent likeness + music license). For v1, rights constraints are informational metadata — the buyer/orchestrator manages creative lifecycle against these terms.",
+      "items": {
+        "$ref": "/schemas/3.0.1/core/rights-constraint.json"
+      }
+    },
+    "industry_identifiers": {
+      "type": "array",
+      "description": "Industry-standard identifiers for this specific manifest (e.g., Ad-ID, ISCI, Clearcast clock number). When present, overrides creative-level identifiers. Use when different format versions of the same source creative have distinct Ad-IDs (e.g., the :15 and :30 cuts).",
+      "items": {
+        "$ref": "/schemas/3.0.1/core/industry-identifier.json"
+      },
+      "uniqueItems": true
+    },
+    "provenance": {
+      "$ref": "/schemas/3.0.1/core/provenance.json",
+      "description": "Provenance metadata for this creative manifest. Serves as the default provenance for all assets in this manifest. An asset with its own provenance replaces this object entirely (no field-level merging)."
+    },
+    "ext": {
+      "$ref": "/schemas/3.0.1/core/ext.json"
+    }
+  },
+  "required": [
+    "format_id",
+    "assets"
+  ],
+  "additionalProperties": true
+}

package/dist/lib/schemas-data/3.0.1/core/creative-policy.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/schemas/3.0.1/core/creative-policy.json",
+  "title": "Creative Policy",
+  "description": "Creative requirements and restrictions for a product",
+  "type": "object",
+  "properties": {
+    "co_branding": {
+      "$ref": "/schemas/3.0.1/enums/co-branding-requirement.json",
+      "description": "Co-branding requirement"
+    },
+    "landing_page": {
+      "$ref": "/schemas/3.0.1/enums/landing-page-requirement.json",
+      "description": "Landing page requirements"
+    },
+    "templates_available": {
+      "type": "boolean",
+      "description": "Whether creative templates are provided"
+    },
+    "provenance_required": {
+      "type": "boolean",
+      "description": "Whether creatives must include provenance metadata. When true, the seller requires buyers to attach provenance declarations to creative submissions. The seller may independently verify claims via get_creative_features."
+    }
+  },
+  "required": [
+    "co_branding",
+    "landing_page",
+    "templates_available"
+  ],
+  "additionalProperties": true
+}

package/dist/lib/schemas-data/3.0.1/core/creative-variable.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/schemas/3.0.1/core/creative-variable.json",
+  "title": "Creative Variable",
+  "description": "A dynamic content variable (DCO slot) on a creative. Variables represent content that can change at serve time — headlines, images, product data, etc.",
+  "type": "object",
+  "properties": {
+    "variable_id": {
+      "type": "string",
+      "description": "Variable identifier on the creative platform"
+    },
+    "name": {
+      "type": "string",
+      "description": "Human-readable variable name"
+    },
+    "variable_type": {
+      "type": "string",
+      "enum": [
+        "text",
+        "image",
+        "video",
+        "audio",
+        "url",
+        "number",
+        "boolean",
+        "color",
+        "date"
+      ],
+      "description": "Data type of the variable. Each type represents a semantic content slot: text (headlines, body copy), image/video/audio (media URLs), url (clickthrough or tracking URLs), number (prices, counts), boolean (conditional flags like show_discount or is_raining), color (hex color values), date (ISO 8601 date-time for countdowns and offer expirations)."
+    },
+    "default_value": {
+      "type": "string",
+      "description": "Default value used when no dynamic value is provided at serve time. All types are string-encoded: text/image/video/audio/url as literal strings, number as decimal (e.g., \"42.99\"), boolean as \"true\"/\"false\", color as \"#RRGGBB\", date as ISO 8601 (e.g., \"2026-12-25T00:00:00Z\")."
+    },
+    "required": {
+      "type": "boolean",
+      "description": "Whether this variable must have a value for the creative to serve",
+      "default": false
+    }
+  },
+  "required": [
+    "variable_id",
+    "name",
+    "variable_type"
+  ],
+  "additionalProperties": true
+}

package/dist/lib/schemas-data/3.0.1/core/creative-variant.json

@@ -0,0 +1,60 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/schemas/3.0.1/core/creative-variant.json",
+  "title": "Creative Variant",
+  "description": "A specific execution variant of a creative with delivery metrics. For catalog-driven packages, each catalog item rendered as a distinct ad execution is a variant — the variant's manifest includes the catalog reference with the specific item rendered. For asset group optimization, represents one combination of assets the platform selected. For generative creative, represents a platform-generated variant. For standard creatives, maps 1:1 with the creative itself.",
+  "type": "object",
+  "allOf": [
+    {
+      "$ref": "/schemas/3.0.1/core/delivery-metrics.json"
+    },
+    {
+      "properties": {
+        "variant_id": {
+          "type": "string",
+          "description": "Platform-assigned identifier for this variant"
+        },
+        "manifest": {
+          "$ref": "/schemas/3.0.1/core/creative-manifest.json",
+          "description": "The rendered creative manifest for this variant — the actual output that was served, not the input assets. Contains format_id and the resolved assets (specific headline, image, video, etc. the platform selected or generated). For Tier 2, shows which asset combination was picked. For Tier 3, contains the generated assets which may differ entirely from the input brand identity. Pass to preview_creative to re-render."
+        },
+        "generation_context": {
+          "type": "object",
+          "description": "Input signals that triggered generation of this variant (Tier 3). Describes why the platform created this specific variant. Platforms should provide summarized or anonymized signals rather than raw user input. For web contexts, may include page topic or URL. For conversational contexts, an anonymized content signal. For search, query category or intent. When the content context is managed through AdCP content standards, reference the artifact directly via the artifact field.",
+          "properties": {
+            "context_type": {
+              "type": "string",
+              "description": "Type of context that triggered generation (e.g., 'web_page', 'conversational', 'search', 'app', 'dooh')"
+            },
+            "artifact": {
+              "type": "object",
+              "description": "Reference to the content-standards artifact that provided the generation context. Links this variant to the specific piece of content (article, video, podcast segment, etc.) where the ad was placed.",
+              "properties": {
+                "property_id": {
+                  "$ref": "/schemas/3.0.1/core/identifier.json",
+                  "description": "Property where the artifact appears"
+                },
+                "artifact_id": {
+                  "type": "string",
+                  "description": "Artifact identifier within the property"
+                }
+              },
+              "required": [
+                "property_id",
+                "artifact_id"
+              ],
+              "additionalProperties": false
+            },
+            "ext": {
+              "$ref": "/schemas/3.0.1/core/ext.json"
+            }
+          },
+          "additionalProperties": true
+        }
+      },
+      "required": [
+        "variant_id"
+      ]
+    }
+  ]
+}

package/dist/lib/schemas-data/3.0.1/core/data-provider-signal-selector.json

@@ -0,0 +1,94 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/schemas/3.0.1/core/data-provider-signal-selector.json",
+  "title": "Data Provider Signal Selector",
+  "description": "Selects signals from a data provider's adagents.json catalog. Used for product definitions and agent authorization. Supports three selection patterns: all signals, specific IDs, or by tags.",
+  "discriminator": {
+    "propertyName": "selection_type"
+  },
+  "oneOf": [
+    {
+      "type": "object",
+      "description": "Select all signals from the data provider",
+      "properties": {
+        "data_provider_domain": {
+          "type": "string",
+          "description": "Domain where data provider's adagents.json is hosted (e.g., 'polk.com')",
+          "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"
+        },
+        "selection_type": {
+          "type": "string",
+          "const": "all",
+          "description": "Discriminator indicating all signals from this data provider are included"
+        }
+      },
+      "required": [
+        "data_provider_domain",
+        "selection_type"
+      ],
+      "additionalProperties": true
+    },
+    {
+      "type": "object",
+      "description": "Select specific signals by ID",
+      "properties": {
+        "data_provider_domain": {
+          "type": "string",
+          "description": "Domain where data provider's adagents.json is hosted (e.g., 'polk.com')",
+          "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"
+        },
+        "selection_type": {
+          "type": "string",
+          "const": "by_id",
+          "description": "Discriminator indicating selection by specific signal IDs"
+        },
+        "signal_ids": {
+          "type": "array",
+          "description": "Specific signal IDs from the data provider's catalog",
+          "items": {
+            "type": "string",
+            "pattern": "^[a-zA-Z0-9_-]+$"
+          },
+          "minItems": 1
+        }
+      },
+      "required": [
+        "data_provider_domain",
+        "selection_type",
+        "signal_ids"
+      ],
+      "additionalProperties": true
+    },
+    {
+      "type": "object",
+      "description": "Select signals by tag membership",
+      "properties": {
+        "data_provider_domain": {
+          "type": "string",
+          "description": "Domain where data provider's adagents.json is hosted (e.g., 'polk.com')",
+          "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"
+        },
+        "selection_type": {
+          "type": "string",
+          "const": "by_tag",
+          "description": "Discriminator indicating selection by signal tags"
+        },
+        "signal_tags": {
+          "type": "array",
+          "description": "Signal tags from the data provider's catalog. Selector covers all signals with these tags",
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z0-9_-]+$"
+          },
+          "minItems": 1
+        }
+      },
+      "required": [
+        "data_provider_domain",
+        "selection_type",
+        "signal_tags"
+      ],
+      "additionalProperties": true
+    }
+  ]
+}

package/dist/lib/schemas-data/3.0.1/core/date-range.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/schemas/3.0.1/core/date-range.json",
+  "title": "Date Range",
+  "description": "A date range with inclusive start and end dates (ISO 8601 calendar dates). Used for billing periods, flight dates, and other calendar-day boundaries.",
+  "type": "object",
+  "properties": {
+    "start": {
+      "type": "string",
+      "format": "date",
+      "description": "Start date (inclusive), ISO 8601"
+    },
+    "end": {
+      "type": "string",
+      "format": "date",
+      "description": "End date (inclusive), ISO 8601"
+    }
+  },
+  "required": [
+    "start",
+    "end"
+  ],
+  "additionalProperties": true
+}

package/dist/lib/schemas-data/3.0.1/core/datetime-range.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/schemas/3.0.1/core/datetime-range.json",
+  "title": "Datetime Range",
+  "description": "A datetime range with inclusive start and end timestamps (ISO 8601 with timezone). Used for measurement windows, reporting periods, and other sub-day precision boundaries.",
+  "type": "object",
+  "properties": {
+    "start": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Start timestamp (inclusive), ISO 8601"
+    },
+    "end": {
+      "type": "string",
+      "format": "date-time",
+      "description": "End timestamp (inclusive), ISO 8601"
+    }
+  },
+  "required": [
+    "start",
+    "end"
+  ],
+  "additionalProperties": true
+}

package/dist/lib/schemas-data/3.0.1/core/daypart-target.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/schemas/3.0.1/core/daypart-target.json",
+  "title": "Daypart Target",
+  "description": "A time window for daypart targeting. Specifies days of week and an hour range. start_hour is inclusive, end_hour is exclusive (e.g., 6-10 = 6:00am to 10:00am). Follows the Google Ads AdScheduleInfo / DV360 DayPartTargeting pattern.",
+  "type": "object",
+  "properties": {
+    "days": {
+      "type": "array",
+      "description": "Days of week this window applies to. Use multiple days for compact targeting (e.g., monday-friday in one object).",
+      "items": {
+        "$ref": "/schemas/3.0.1/enums/day-of-week.json"
+      },
+      "minItems": 1
+    },
+    "start_hour": {
+      "type": "integer",
+      "description": "Start hour (inclusive), 0-23 in 24-hour format. 0 = midnight, 6 = 6:00am, 18 = 6:00pm.",
+      "minimum": 0,
+      "maximum": 23
+    },
+    "end_hour": {
+      "type": "integer",
+      "description": "End hour (exclusive), 1-24 in 24-hour format. 10 = 10:00am, 24 = midnight. Must be greater than start_hour.",
+      "minimum": 1,
+      "maximum": 24
+    },
+    "label": {
+      "type": "string",
+      "description": "Optional human-readable name for this time window (e.g., 'Morning Drive', 'Prime Time')"
+    }
+  },
+  "required": [
+    "days",
+    "start_hour",
+    "end_hour"
+  ],
+  "additionalProperties": false
+}

package/dist/lib/schemas-data/3.0.1/core/deadline-policy.json

@@ -0,0 +1,58 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/schemas/3.0.1/core/deadline-policy.json",
+  "title": "Deadline Policy",
+  "description": "Default deadline rules for installments that do not declare their own deadlines. Agents compute absolute deadlines from the installment's scheduled_at and these lead times. Installments with explicit deadlines override this policy. booking_lead_days SHOULD be >= cancellation_lead_days (bookings close before cancellation window closes).",
+  "type": "object",
+  "properties": {
+    "booking_lead_days": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Days before scheduled_at by which the placement must be booked"
+    },
+    "cancellation_lead_days": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Days before scheduled_at by which cancellation is penalty-free"
+    },
+    "material_stages": {
+      "type": "array",
+      "description": "Default material submission stages. Items MUST be in chronological order (earliest due first). Agents compute due_at as: installment.scheduled_at minus lead_days.",
+      "items": {
+        "type": "object",
+        "properties": {
+          "stage": {
+            "type": "string",
+            "description": "Stage identifier. Standard values: 'draft' (needs seller processing), 'final' (production-ready).",
+            "examples": [
+              "draft",
+              "final"
+            ]
+          },
+          "lead_days": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Days before scheduled_at this stage is due"
+          },
+          "label": {
+            "type": "string",
+            "description": "What the seller needs at this stage"
+          }
+        },
+        "required": [
+          "stage",
+          "lead_days"
+        ],
+        "additionalProperties": true
+      },
+      "minItems": 1
+    },
+    "business_days_only": {
+      "type": "boolean",
+      "description": "When true, lead_days counts business days (Mon-Fri) rather than calendar days. Defaults to false.",
+      "default": false
+    }
+  },
+  "minProperties": 1,
+  "additionalProperties": true
+}

package/dist/lib/schemas-data/3.0.1/core/delivery-forecast.json

@@ -0,0 +1,86 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/schemas/3.0.1/core/delivery-forecast.json",
+  "title": "Delivery Forecast",
+  "description": "Forecasted delivery metrics for a proposal or product allocation. Publishers attach points to help buyers evaluate expected campaign performance before purchase.",
+  "type": "object",
+  "properties": {
+    "points": {
+      "type": "array",
+      "description": "Forecasted delivery data points. For spend curves (default), points at ascending budget levels show how metrics scale with spend. For availability forecasts, points represent total available inventory independent of budget. See forecast_range_unit for interpretation.",
+      "items": {
+        "$ref": "/schemas/3.0.1/core/forecast-point.json"
+      },
+      "minItems": 1
+    },
+    "forecast_range_unit": {
+      "$ref": "/schemas/3.0.1/enums/forecast-range-unit.json",
+      "description": "How to interpret the points array. 'spend' (default when omitted): points at ascending budget levels. 'availability': total available inventory, budget omitted. 'reach_freq': points at ascending reach/frequency targets. 'weekly'/'daily': metrics are per-period values. 'clicks'/'conversions': points at ascending outcome targets. 'package': each point is a distinct inventory package."
+    },
+    "method": {
+      "$ref": "/schemas/3.0.1/enums/forecast-method.json",
+      "description": "Method used to produce this forecast"
+    },
+    "currency": {
+      "type": "string",
+      "description": "ISO 4217 currency code for monetary values in this forecast (spend, budget)"
+    },
+    "demographic_system": {
+      "$ref": "/schemas/3.0.1/enums/demographic-system.json",
+      "description": "Measurement system for the demographic field. Ensures buyer and seller agree on demographic notation."
+    },
+    "demographic": {
+      "type": "string",
+      "description": "Target demographic code within the specified demographic_system. For Nielsen: P18-49, M25-54, W35+. For BARB: ABC1 Adults, 16-34. For AGF: E 14-49.",
+      "examples": [
+        "P18-49",
+        "A25-54",
+        "W35+",
+        "M18-34"
+      ]
+    },
+    "measurement_source": {
+      "type": "string",
+      "maxLength": 64,
+      "pattern": "^[a-z0-9_]+$",
+      "description": "Third-party measurement provider whose data was used to produce this forecast. Distinct from demographic_system, which specifies demographic notation — measurement_source identifies whose data produced the forecast numbers. Should be present when measured_impressions is used. Lowercase slug format.",
+      "examples": [
+        "nielsen",
+        "videoamp",
+        "comscore",
+        "geopath",
+        "barb",
+        "agf",
+        "oztam",
+        "kantar",
+        "barc",
+        "route",
+        "rajar",
+        "triton"
+      ]
+    },
+    "reach_unit": {
+      "$ref": "/schemas/3.0.1/enums/reach-unit.json",
+      "description": "Unit of measurement for reach and audience_size metrics in this forecast. Required for cross-channel forecast comparison."
+    },
+    "generated_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "When this forecast was computed"
+    },
+    "valid_until": {
+      "type": "string",
+      "format": "date-time",
+      "description": "When this forecast expires. After this time, the forecast should be refreshed. Forecast expiry does not affect proposal executability."
+    },
+    "ext": {
+      "$ref": "/schemas/3.0.1/core/ext.json"
+    }
+  },
+  "required": [
+    "points",
+    "method",
+    "currency"
+  ],
+  "additionalProperties": true
+}