adcp 2.17.0__py3-none-any.whl → 2.18.0__py3-none-any.whl

adcp/types/generated_poc/core/delivery_metrics.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/delivery_metrics.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -12,7 +12,7 @@ from pydantic import ConfigDict, Field
 
 class VenueBreakdownItem(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     impressions: Annotated[int, Field(description='Impressions delivered at this venue', ge=0)]
     loop_plays: Annotated[int | None, Field(description='Loop plays at this venue', ge=0)] = None
@@ -29,7 +29,7 @@ class VenueBreakdownItem(AdCPBaseModel):
 
 class DoohMetrics(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     calculation_notes: Annotated[
         str | None, Field(description='Explanation of how DOOH impressions were calculated')

adcp/types/generated_poc/core/deployment.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/deployment.json
-#   timestamp: 2025-12-11T15:09:37+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -14,7 +14,7 @@ from . import activation_key as activation_key_1
 
 class Deployment1(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     account: Annotated[str | None, Field(description='Account identifier if applicable')] = None
     activation_key: Annotated[
@@ -46,7 +46,7 @@ class Deployment1(AdCPBaseModel):
 
 class Deployment2(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     account: Annotated[str | None, Field(description='Account identifier if applicable')] = None
     activation_key: Annotated[

adcp/types/generated_poc/core/destination.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/destination.json
-#   timestamp: 2025-12-11T15:09:37+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -12,7 +12,7 @@ from pydantic import AnyUrl, ConfigDict, Field, RootModel
 
 class Destination1(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     account: Annotated[
         str | None, Field(description='Optional account identifier on the platform')
@@ -29,7 +29,7 @@ class Destination1(AdCPBaseModel):
 
 class Destination2(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     account: Annotated[
         str | None, Field(description='Optional account identifier on the agent')

adcp/types/generated_poc/core/error.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/error.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -12,12 +12,12 @@ from pydantic import ConfigDict, Field
 
 class Error(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     code: Annotated[str, Field(description='Error code for programmatic handling')]
-    details: Annotated[Any | None, Field(description='Additional task-specific error details')] = (
-        None
-    )
+    details: Annotated[
+        dict[str, Any] | None, Field(description='Additional task-specific error details')
+    ] = None
     field: Annotated[
         str | None,
         Field(description="Field path associated with the error (e.g., 'packages[0].targeting')"),

adcp/types/generated_poc/core/ext.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/ext.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -9,7 +9,6 @@ from pydantic import ConfigDict
 
 
 class ExtensionObject(AdCPBaseModel):
-    pass
     model_config = ConfigDict(
         extra='allow',
     )

adcp/types/generated_poc/core/format.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/format.json
-#   timestamp: 2025-12-18T20:00:24+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -13,6 +13,84 @@ from ..enums import asset_content_type, format_category, format_id_parameter
 from . import format_id as format_id_1
 
 
+class Assets(AdCPBaseModel):
+    asset_id: Annotated[
+        str,
+        Field(
+            description='Unique identifier for this asset. Creative manifests MUST use this exact value as the key in the assets object.'
+        ),
+    ]
+    asset_role: Annotated[
+        str | None,
+        Field(
+            description="Optional descriptive label for this asset's purpose (e.g., 'hero_image', 'logo', 'third_party_tracking'). Not used for referencing assets in manifests—use asset_id instead. This field is for human-readable documentation and UI display only."
+        ),
+    ] = None
+    asset_type: Annotated[asset_content_type.AssetContentType, Field(description='Type of asset')]
+    item_type: Annotated[
+        Literal['individual'],
+        Field(description='Discriminator indicating this is an individual asset'),
+    ]
+    required: Annotated[
+        bool,
+        Field(
+            description='Whether this asset is required (true) or optional (false). Required assets must be provided for a valid creative. Optional assets enhance the creative but are not mandatory.'
+        ),
+    ]
+    requirements: Annotated[
+        dict[str, Any] | None,
+        Field(
+            description='Technical requirements for this asset (dimensions, file size, duration, etc.). For template formats, use parameters_from_format_id: true to indicate asset parameters must match the format_id parameters (width/height/unit and/or duration_ms).'
+        ),
+    ] = None
+
+
+class Asset(AdCPBaseModel):
+    asset_id: Annotated[str, Field(description='Identifier for this asset within the group')]
+    asset_role: Annotated[
+        str | None,
+        Field(
+            description="Optional descriptive label for this asset's purpose. Not used for referencing assets in manifests—use asset_id instead. This field is for human-readable documentation and UI display only."
+        ),
+    ] = None
+    asset_type: Annotated[asset_content_type.AssetContentType, Field(description='Type of asset')]
+    required: Annotated[
+        bool,
+        Field(description='Whether this asset is required within each repetition of the group'),
+    ]
+    requirements: Annotated[
+        dict[str, Any] | None,
+        Field(
+            description='Technical requirements for this asset. For template formats, use parameters_from_format_id: true to indicate asset parameters must match the format_id parameters (width/height/unit and/or duration_ms).'
+        ),
+    ] = None
+
+
+class Assets1(AdCPBaseModel):
+    asset_group_id: Annotated[
+        str, Field(description="Identifier for this asset group (e.g., 'product', 'slide', 'card')")
+    ]
+    assets: Annotated[list[Asset], Field(description='Assets within each repetition of this group')]
+    item_type: Annotated[
+        Literal['repeatable_group'],
+        Field(description='Discriminator indicating this is a repeatable asset group'),
+    ]
+    max_count: Annotated[int, Field(description='Maximum number of repetitions allowed', ge=1)]
+    min_count: Annotated[
+        int,
+        Field(
+            description='Minimum number of repetitions required (if group is required) or allowed (if optional)',
+            ge=0,
+        ),
+    ]
+    required: Annotated[
+        bool,
+        Field(
+            description='Whether this asset group is required. If true, at least min_count repetitions must be provided.'
+        ),
+    ]
+
+
 class AssetsRequired(AdCPBaseModel):
     asset_id: Annotated[
         str,
@@ -40,7 +118,7 @@ class AssetsRequired(AdCPBaseModel):
     ] = None
 
 
-class Asset(AdCPBaseModel):
+class Asset2(AdCPBaseModel):
     asset_id: Annotated[str, Field(description='Identifier for this asset within the group')]
     asset_role: Annotated[
         str | None,
@@ -64,7 +142,9 @@ class AssetsRequired1(AdCPBaseModel):
     asset_group_id: Annotated[
         str, Field(description="Identifier for this asset group (e.g., 'product', 'slide', 'card')")
     ]
-    assets: Annotated[list[Asset], Field(description='Assets within each repetition of this group')]
+    assets: Annotated[
+        list[Asset2], Field(description='Assets within each repetition of this group')
+    ]
     item_type: Annotated[
         Literal['repeatable_group'],
         Field(description='Discriminator indicating this is a repeatable asset group'),
@@ -146,7 +226,7 @@ class Renders1(AdCPBaseModel):
 
 class FormatCard(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     format_id: Annotated[
         format_id_1.FormatId,
@@ -162,7 +242,7 @@ class FormatCard(AdCPBaseModel):
 
 class FormatCardDetailed(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     format_id: Annotated[
         format_id_1.FormatId,
@@ -180,7 +260,7 @@ class FormatCardDetailed(AdCPBaseModel):
 
 class Format(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     accepts_parameters: Annotated[
         list[format_id_parameter.FormatIdParameter] | None,
@@ -188,10 +268,17 @@ class Format(AdCPBaseModel):
             description='List of parameters this format accepts in format_id. Template formats define which parameters (dimensions, duration, etc.) can be specified when instantiating the format. Empty or omitted means this is a concrete format with fixed parameters.'
         ),
     ] = None
+    assets: Annotated[
+        list[Assets | Assets1] | None,
+        Field(
+            description="Array of all assets supported for this format. Each asset is identified by its asset_id, which must be used as the key in creative manifests. Use the 'required' boolean on each asset to indicate whether it's mandatory. This field replaces the deprecated 'assets_required' and enables full asset discovery for buyers and AI agents."
+        ),
+    ] = None
     assets_required: Annotated[
         list[AssetsRequired | AssetsRequired1] | None,
         Field(
-            description='Array of required assets or asset groups for this format. Each asset is identified by its asset_id, which must be used as the key in creative manifests. Can contain individual assets or repeatable asset sequences (e.g., carousel products, slideshow frames).'
+            deprecated=True,
+            description="DEPRECATED: Use 'assets' instead. Array of required assets or asset groups for this format. Each asset is identified by its asset_id, which must be used as the key in creative manifests. Can contain individual assets or repeatable asset sequences (e.g., carousel products, slideshow frames). This field is maintained for backward compatibility; new implementations should use 'assets' with the 'required' boolean on each asset."
         ),
     ] = None
     delivery: Annotated[

adcp/types/generated_poc/core/format_id.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/format_id.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -12,7 +12,7 @@ from pydantic import AnyUrl, ConfigDict, Field
 
 class FormatId(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     agent_url: Annotated[
         AnyUrl,

adcp/types/generated_poc/core/frequency_cap.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/frequency_cap.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -12,7 +12,7 @@ from pydantic import ConfigDict, Field
 
 class FrequencyCap(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     suppress_minutes: Annotated[
         float, Field(description='Minutes to suppress after impression', ge=0.0)

adcp/types/generated_poc/core/measurement.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/measurement.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -12,7 +12,7 @@ from pydantic import ConfigDict, Field
 
 class Measurement(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     attribution: Annotated[
         str,

adcp/types/generated_poc/core/media_buy.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/media_buy.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -16,7 +16,7 @@ from . import package
 
 class MediaBuy(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     buyer_ref: Annotated[
         str | None, Field(description="Buyer's reference identifier for this media buy")

adcp/types/generated_poc/core/package.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/package.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -17,7 +17,7 @@ from . import format_id, targeting
 
 class Package(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     bid_price: Annotated[
         float | None,

adcp/types/generated_poc/core/performance_feedback.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/performance_feedback.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -16,7 +16,7 @@ from ..enums import metric_type as metric_type_1
 
 class MeasurementPeriod(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     end: Annotated[
         AwareDatetime, Field(description='ISO 8601 end timestamp for measurement period')
@@ -35,7 +35,7 @@ class Status(Enum):
 
 class PerformanceFeedback(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     applied_at: Annotated[
         AwareDatetime | None,

adcp/types/generated_poc/core/placement.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/placement.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -14,7 +14,7 @@ from . import format_id
 
 class Placement(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     description: Annotated[
         str | None, Field(description='Detailed description of where and how the placement appears')

adcp/types/generated_poc/core/product.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/product.json
-#   timestamp: 2025-12-11T15:09:37+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -35,7 +35,7 @@ class DeliveryMeasurement(AdCPBaseModel):
 
 class ProductCard(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     format_id: Annotated[
         format_id_1.FormatId,
@@ -51,7 +51,7 @@ class ProductCard(AdCPBaseModel):
 
 class ProductCardDetailed(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     format_id: Annotated[
         format_id_1.FormatId,
@@ -69,7 +69,7 @@ class ProductCardDetailed(AdCPBaseModel):
 
 class Product(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     brief_relevance: Annotated[
         str | None,

adcp/types/generated_poc/core/product_filters.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/product_filters.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -18,7 +18,7 @@ from . import format_id
 
 class BudgetRange(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     currency: Annotated[
         str,
@@ -32,7 +32,7 @@ class BudgetRange(AdCPBaseModel):
 
 class BudgetRange1(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     currency: Annotated[
         str,
@@ -50,7 +50,7 @@ class Country(RootModel[str]):
 
 class ProductFilters(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     budget_range: Annotated[
         BudgetRange | BudgetRange1 | None,

adcp/types/generated_poc/core/promoted_offerings.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/promoted_offerings.json
-#   timestamp: 2025-12-11T15:09:37+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -29,7 +29,7 @@ class AssetType(Enum):
 
 class AssetSelectors(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     asset_types: Annotated[
         list[AssetType] | None, Field(description="Filter by asset type (e.g., ['image', 'video'])")
@@ -45,7 +45,7 @@ class AssetSelectors(AdCPBaseModel):
 
 class Offering(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     assets: Annotated[
         list[dict[str, Any]] | None, Field(description='Assets specific to this offering')
@@ -60,7 +60,7 @@ class Offering(AdCPBaseModel):
 
 class PromotedOfferings(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     asset_selectors: Annotated[
         AssetSelectors | None,

adcp/types/generated_poc/core/promoted_products.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/promoted_products.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -12,7 +12,7 @@ from pydantic import ConfigDict, Field
 
 class PromotedProducts(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     manifest_category: Annotated[
         str | None,

adcp/types/generated_poc/core/property.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/property.json
-#   timestamp: 2025-12-11T15:09:37+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -17,7 +17,7 @@ from . import property_tag
 
 class Identifier(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     type: Annotated[
         identifier_types.PropertyIdentifierTypes,
@@ -33,7 +33,7 @@ class Identifier(AdCPBaseModel):
 
 class Property(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     identifiers: Annotated[
         list[Identifier], Field(description='Array of identifiers for this property', min_length=1)

adcp/types/generated_poc/core/protocol_envelope.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/protocol_envelope.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -15,7 +15,7 @@ from . import push_notification_config as push_notification_config_1
 
 class ProtocolEnvelope(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     context_id: Annotated[
         str | None,

adcp/types/generated_poc/core/publisher_property_selector.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/publisher_property_selector.json
-#   timestamp: 2025-12-11T15:09:37+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -14,7 +14,7 @@ from . import property_id, property_tag
 
 class PublisherPropertySelector1(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     publisher_domain: Annotated[
         str,
@@ -33,7 +33,7 @@ class PublisherPropertySelector1(AdCPBaseModel):
 
 class PublisherPropertySelector2(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     property_ids: Annotated[
         list[property_id.PropertyId],
@@ -54,7 +54,7 @@ class PublisherPropertySelector2(AdCPBaseModel):
 
 class PublisherPropertySelector3(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     property_tags: Annotated[
         list[property_tag.PropertyTag],

adcp/types/generated_poc/core/reporting_capabilities.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/reporting_capabilities.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -14,7 +14,7 @@ from ..enums import available_metric, reporting_frequency
 
 class ReportingCapabilities(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     available_metrics: Annotated[
         list[available_metric.AvailableMetric],

adcp/types/generated_poc/core/response.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/response.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -12,7 +12,7 @@ from pydantic import ConfigDict, Field
 
 class ProtocolResponse(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     context_id: Annotated[str | None, Field(description='Session continuity identifier')] = None
     data: Annotated[

adcp/types/generated_poc/core/signal_filters.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/signal_filters.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -14,7 +14,7 @@ from ..enums import signal_catalog_type
 
 class SignalFilters(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     catalog_types: Annotated[
         list[signal_catalog_type.SignalCatalogType] | None,