adcp 2.19.0__py3-none-any.whl → 3.1.0__py3-none-any.whl

adcp/types/generated_poc/core/publisher_property_selector.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/publisher_property_selector.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -14,26 +14,26 @@ from . import property_id, property_tag
 
 class PublisherPropertySelector1(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     publisher_domain: Annotated[
         str,
         Field(
             description="Domain where publisher's adagents.json is hosted (e.g., 'cnn.com')",
-            pattern="^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$",
+            pattern='^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$',
         ),
     ]
     selection_type: Annotated[
-        Literal["all"],
+        Literal['all'],
         Field(
-            description="Discriminator indicating all properties from this publisher are included"
+            description='Discriminator indicating all properties from this publisher are included'
         ),
     ]
 
 
 class PublisherPropertySelector2(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     property_ids: Annotated[
         list[property_id.PropertyId],
@@ -43,18 +43,18 @@ class PublisherPropertySelector2(AdCPBaseModel):
         str,
         Field(
             description="Domain where publisher's adagents.json is hosted (e.g., 'cnn.com')",
-            pattern="^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$",
+            pattern='^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$',
         ),
     ]
     selection_type: Annotated[
-        Literal["by_id"],
-        Field(description="Discriminator indicating selection by specific property IDs"),
+        Literal['by_id'],
+        Field(description='Discriminator indicating selection by specific property IDs'),
     ]
 
 
 class PublisherPropertySelector3(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     property_tags: Annotated[
         list[property_tag.PropertyTag],
@@ -67,11 +67,11 @@ class PublisherPropertySelector3(AdCPBaseModel):
         str,
         Field(
             description="Domain where publisher's adagents.json is hosted (e.g., 'cnn.com')",
-            pattern="^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$",
+            pattern='^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$',
         ),
     ]
     selection_type: Annotated[
-        Literal["by_tag"], Field(description="Discriminator indicating selection by property tags")
+        Literal['by_tag'], Field(description='Discriminator indicating selection by property tags')
     ]
 
 
@@ -82,7 +82,7 @@ class PublisherPropertySelector(
         PublisherPropertySelector1 | PublisherPropertySelector2 | PublisherPropertySelector3,
         Field(
             description="Selects properties from a publisher's adagents.json. Used for both product definitions and agent authorization. Supports three selection patterns: all properties, specific IDs, or by tags.",
-            discriminator="selection_type",
-            title="Publisher Property Selector",
+            discriminator='selection_type',
+            title='Publisher Property Selector',
         ),
     ]

adcp/types/generated_poc/core/push_notification_config.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/push_notification_config.json
-#   timestamp: 2025-12-18T20:00:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -14,12 +14,12 @@ from ..enums import auth_scheme
 
 class Authentication(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="forbid",
+        extra='forbid',
     )
     credentials: Annotated[
         str,
         Field(
-            description="Credentials for authentication. For Bearer: token sent in Authorization header. For HMAC-SHA256: shared secret used to generate signature. Minimum 32 characters. Exchanged out-of-band during onboarding.",
+            description='Credentials for authentication. For Bearer: token sent in Authorization header. For HMAC-SHA256: shared secret used to generate signature. Minimum 32 characters. Exchanged out-of-band during onboarding.',
             min_length=32,
         ),
     ]
@@ -36,13 +36,13 @@ class Authentication(AdCPBaseModel):
 class PushNotificationConfig(AdCPBaseModel):
     authentication: Annotated[
         Authentication,
-        Field(description="Authentication configuration for webhook delivery (A2A-compatible)"),
+        Field(description='Authentication configuration for webhook delivery (A2A-compatible)'),
     ]
     token: Annotated[
         str | None,
         Field(
-            description="Optional client-provided token for webhook validation. Echoed back in webhook payload to validate request authenticity.",
+            description='Optional client-provided token for webhook validation. Echoed back in webhook payload to validate request authenticity.',
             min_length=16,
         ),
     ] = None
-    url: Annotated[AnyUrl, Field(description="Webhook endpoint URL for task status notifications")]
+    url: Annotated[AnyUrl, Field(description='Webhook endpoint URL for task status notifications')]

adcp/types/generated_poc/core/reporting_capabilities.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/reporting_capabilities.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -14,38 +14,38 @@ from ..enums import available_metric, reporting_frequency
 
 class ReportingCapabilities(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     available_metrics: Annotated[
         list[available_metric.AvailableMetric],
         Field(
-            description="Metrics available in reporting. Impressions and spend are always implicitly included.",
+            description='Metrics available in reporting. Impressions and spend are always implicitly included.',
             examples=[
-                ["impressions", "spend", "clicks", "video_completions"],
-                ["impressions", "spend", "conversions"],
+                ['impressions', 'spend', 'clicks', 'video_completions'],
+                ['impressions', 'spend', 'conversions'],
             ],
         ),
     ]
     available_reporting_frequencies: Annotated[
         list[reporting_frequency.ReportingFrequency],
-        Field(description="Supported reporting frequency options", min_length=1),
+        Field(description='Supported reporting frequency options', min_length=1),
     ]
     expected_delay_minutes: Annotated[
         int,
         Field(
-            description="Expected delay in minutes before reporting data becomes available (e.g., 240 for 4-hour delay)",
+            description='Expected delay in minutes before reporting data becomes available (e.g., 240 for 4-hour delay)',
             examples=[240, 300, 1440],
             ge=0,
         ),
     ]
     supports_webhooks: Annotated[
         bool,
-        Field(description="Whether this product supports webhook-based reporting notifications"),
+        Field(description='Whether this product supports webhook-based reporting notifications'),
     ]
     timezone: Annotated[
         str,
         Field(
             description="Timezone for reporting periods. Use 'UTC' or IANA timezone (e.g., 'America/New_York'). Critical for daily/monthly frequency alignment.",
-            examples=["UTC", "America/New_York", "Europe/London", "America/Los_Angeles"],
+            examples=['UTC', 'America/New_York', 'Europe/London', 'America/Los_Angeles'],
         ),
     ]

adcp/types/generated_poc/core/reporting_webhook.py

@@ -0,0 +1,70 @@
+# generated by datamodel-codegen:
+#   filename:  core/reporting_webhook.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from enum import Enum
+from typing import Annotated
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import AnyUrl, ConfigDict, Field
+
+from ..enums import auth_scheme, available_metric
+
+
+class Authentication(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    credentials: Annotated[
+        str,
+        Field(
+            description='Credentials for authentication. For Bearer: token sent in Authorization header. For HMAC-SHA256: shared secret used to generate signature. Minimum 32 characters. Exchanged out-of-band during onboarding.',
+            min_length=32,
+        ),
+    ]
+    schemes: Annotated[
+        list[auth_scheme.AuthenticationScheme],
+        Field(
+            description="Array of authentication schemes. Supported: ['Bearer'] for simple token auth, ['HMAC-SHA256'] for signature verification (recommended for production)",
+            max_length=1,
+            min_length=1,
+        ),
+    ]
+
+
+class ReportingFrequency(Enum):
+    hourly = 'hourly'
+    daily = 'daily'
+    monthly = 'monthly'
+
+
+class ReportingWebhook(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    authentication: Annotated[
+        Authentication,
+        Field(description='Authentication configuration for webhook delivery (A2A-compatible)'),
+    ]
+    reporting_frequency: Annotated[
+        ReportingFrequency,
+        Field(
+            description='Frequency for automated reporting delivery. Must be supported by all products in the media buy.'
+        ),
+    ]
+    requested_metrics: Annotated[
+        list[available_metric.AvailableMetric] | None,
+        Field(
+            description="Optional list of metrics to include in webhook notifications. If omitted, all available metrics are included. Must be subset of product's available_metrics."
+        ),
+    ] = None
+    token: Annotated[
+        str | None,
+        Field(
+            description='Optional client-provided token for webhook validation. Echoed back in webhook payload to validate request authenticity.',
+            min_length=16,
+        ),
+    ] = None
+    url: Annotated[AnyUrl, Field(description='Webhook endpoint URL for reporting notifications')]

adcp/types/generated_poc/core/response.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/response.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -12,13 +12,13 @@ from pydantic import ConfigDict, Field
 
 class ProtocolResponse(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
-    context_id: Annotated[str | None, Field(description="Session continuity identifier")] = None
+    context_id: Annotated[str | None, Field(description='Session continuity identifier')] = None
     data: Annotated[
         Any | None,
         Field(
-            description="AdCP task-specific response data (see individual task response schemas)"
+            description='AdCP task-specific response data (see individual task response schemas)'
         ),
     ] = None
-    message: Annotated[str, Field(description="Human-readable summary")]
+    message: Annotated[str, Field(description='Human-readable summary')]

adcp/types/generated_poc/core/signal_filters.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/signal_filters.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -14,16 +14,16 @@ from ..enums import signal_catalog_type
 
 class SignalFilters(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     catalog_types: Annotated[
         list[signal_catalog_type.SignalCatalogType] | None,
-        Field(description="Filter by catalog type"),
+        Field(description='Filter by catalog type'),
     ] = None
     data_providers: Annotated[
-        list[str] | None, Field(description="Filter by specific data providers")
+        list[str] | None, Field(description='Filter by specific data providers')
     ] = None
-    max_cpm: Annotated[float | None, Field(description="Maximum CPM price filter", ge=0.0)] = None
+    max_cpm: Annotated[float | None, Field(description='Maximum CPM price filter', ge=0.0)] = None
     min_coverage_percentage: Annotated[
-        float | None, Field(description="Minimum coverage requirement", ge=0.0, le=100.0)
+        float | None, Field(description='Minimum coverage requirement', ge=0.0, le=100.0)
     ] = None

adcp/types/generated_poc/core/start_timing.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/start_timing.json
-#   timestamp: 2026-01-14T17:08:13+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -9,10 +9,10 @@ from typing import Annotated, Literal
 from pydantic import AwareDatetime, Field, RootModel
 
 
-class StartTiming(RootModel[Literal["asap"] | AwareDatetime]):
+class StartTiming(RootModel[Literal['asap'] | AwareDatetime]):
     root: Annotated[
-        Literal["asap"] | AwareDatetime,
+        Literal['asap'] | AwareDatetime,
         Field(
-            description="Campaign start timing: 'asap' or ISO 8601 date-time", title="Start Timing"
+            description="Campaign start timing: 'asap' or ISO 8601 date-time", title='Start Timing'
         ),
     ]

adcp/types/generated_poc/core/sub_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/sub_asset.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -12,45 +12,45 @@ from pydantic import AnyUrl, ConfigDict, Field, RootModel
 
 class SubAsset1(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     asset_id: Annotated[
-        str, Field(description="Unique identifier for the asset within the creative")
+        str, Field(description='Unique identifier for the asset within the creative')
     ]
     asset_kind: Annotated[
-        Literal["media"],
-        Field(description="Discriminator indicating this is a media asset with content_uri"),
+        Literal['media'],
+        Field(description='Discriminator indicating this is a media asset with content_uri'),
     ]
     asset_type: Annotated[
         str,
         Field(
-            description="Type of asset. Common types: thumbnail_image, product_image, featured_image, logo"
+            description='Type of asset. Common types: thumbnail_image, product_image, featured_image, logo'
         ),
     ]
-    content_uri: Annotated[AnyUrl, Field(description="URL for media assets (images, videos, etc.)")]
+    content_uri: Annotated[AnyUrl, Field(description='URL for media assets (images, videos, etc.)')]
 
 
 class SubAsset2(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     asset_id: Annotated[
-        str, Field(description="Unique identifier for the asset within the creative")
+        str, Field(description='Unique identifier for the asset within the creative')
     ]
     asset_kind: Annotated[
-        Literal["text"],
-        Field(description="Discriminator indicating this is a text asset with content"),
+        Literal['text'],
+        Field(description='Discriminator indicating this is a text asset with content'),
     ]
     asset_type: Annotated[
         str,
         Field(
-            description="Type of asset. Common types: headline, body_text, cta_text, price_text, sponsor_name, author_name, click_url"
+            description='Type of asset. Common types: headline, body_text, cta_text, price_text, sponsor_name, author_name, click_url'
         ),
     ]
     content: Annotated[
         str | list[str],
         Field(
-            description="Text content for text-based assets like headlines, body text, CTA text, etc."
+            description='Text content for text-based assets like headlines, body text, CTA text, etc.'
         ),
     ]
 
@@ -59,7 +59,7 @@ class SubAsset(RootModel[SubAsset1 | SubAsset2]):
     root: Annotated[
         SubAsset1 | SubAsset2,
         Field(
-            description="Sub-asset for multi-asset creative formats, including carousel images and native ad template variables",
-            title="Sub-Asset",
+            description='Sub-asset for multi-asset creative formats, including carousel images and native ad template variables',
+            title='Sub-Asset',
         ),
     ]

adcp/types/generated_poc/core/targeting.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/targeting.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -9,45 +9,86 @@ from typing import Annotated
 from adcp.types.base import AdCPBaseModel
 from pydantic import ConfigDict, Field, RootModel
 
+from ..enums import metro_system, postal_system
 from . import frequency_cap as frequency_cap_1
 
 
-class GeoCountryAnyOfItem(RootModel[str]):
-    root: Annotated[str, Field(pattern="^[A-Z]{2}$")]
+class GeoCountry(RootModel[str]):
+    root: Annotated[str, Field(pattern='^[A-Z]{2}$')]
+
+
+class GeoMetro(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    system: Annotated[
+        metro_system.MetroAreaSystem,
+        Field(description="Metro area classification system (e.g., 'nielsen_dma', 'uk_itl2')"),
+    ]
+    values: Annotated[
+        list[str],
+        Field(
+            description="Metro codes within the system (e.g., ['501', '602'] for Nielsen DMAs)",
+            min_length=1,
+        ),
+    ]
+
+
+class GeoPostalArea(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    system: Annotated[
+        postal_system.PostalCodeSystem,
+        Field(
+            description="Postal code system (e.g., 'us_zip', 'gb_outward'). System name encodes country and precision."
+        ),
+    ]
+    values: Annotated[
+        list[str],
+        Field(
+            description="Postal codes within the system (e.g., ['10001', '10002'] for us_zip)",
+            min_length=1,
+        ),
+    ]
+
+
+class GeoRegion(RootModel[str]):
+    root: Annotated[str, Field(pattern='^[A-Z]{2}-[A-Z0-9]{1,3}$')]
 
 
 class TargetingOverlay(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     axe_exclude_segment: Annotated[
-        str | None, Field(description="AXE segment ID to exclude from targeting")
+        str | None, Field(description='AXE segment ID to exclude from targeting')
     ] = None
     axe_include_segment: Annotated[
-        str | None, Field(description="AXE segment ID to include for targeting")
+        str | None, Field(description='AXE segment ID to include for targeting')
     ] = None
     frequency_cap: frequency_cap_1.FrequencyCap | None = None
-    geo_country_any_of: Annotated[
-        list[GeoCountryAnyOfItem] | None,
+    geo_countries: Annotated[
+        list[GeoCountry] | None,
         Field(
-            description="Restrict delivery to specific countries (ISO codes). Use for regulatory compliance or RCT testing."
+            description="Restrict delivery to specific countries. ISO 3166-1 alpha-2 codes (e.g., 'US', 'GB', 'DE')."
         ),
     ] = None
-    geo_metro_any_of: Annotated[
-        list[str] | None,
+    geo_metros: Annotated[
+        list[GeoMetro] | None,
         Field(
-            description="Restrict delivery to specific metro areas (DMA codes). Use for regulatory compliance or RCT testing."
+            description='Restrict delivery to specific metro areas. Each entry specifies the classification system and target values. Seller must declare supported systems in get_adcp_capabilities.'
         ),
     ] = None
-    geo_postal_code_any_of: Annotated[
-        list[str] | None,
+    geo_postal_areas: Annotated[
+        list[GeoPostalArea] | None,
         Field(
-            description="Restrict delivery to specific postal/ZIP codes. Use for regulatory compliance or RCT testing."
+            description='Restrict delivery to specific postal areas. Each entry specifies the postal system and target values. Seller must declare supported systems in get_adcp_capabilities.'
         ),
     ] = None
-    geo_region_any_of: Annotated[
-        list[str] | None,
+    geo_regions: Annotated[
+        list[GeoRegion] | None,
         Field(
-            description="Restrict delivery to specific regions/states. Use for regulatory compliance or RCT testing."
+            description="Restrict delivery to specific regions/states. ISO 3166-2 subdivision codes (e.g., 'US-CA', 'GB-SCT')."
         ),
     ] = None

adcp/types/generated_poc/creative/list_creative_formats_request.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  creative/list_creative_formats_request.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -16,25 +16,25 @@ from ..core import format_id
 
 
 class AssetType(Enum):
-    image = "image"
-    video = "video"
-    audio = "audio"
-    text = "text"
-    html = "html"
-    javascript = "javascript"
-    url = "url"
+    image = 'image'
+    video = 'video'
+    audio = 'audio'
+    text = 'text'
+    html = 'html'
+    javascript = 'javascript'
+    url = 'url'
 
 
 class Type(Enum):
-    audio = "audio"
-    video = "video"
-    display = "display"
-    dooh = "dooh"
+    audio = 'audio'
+    video = 'video'
+    display = 'display'
+    dooh = 'dooh'
 
 
 class ListCreativeFormatsRequestCreativeAgent(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     asset_types: Annotated[
         list[AssetType] | None,
@@ -45,44 +45,44 @@ class ListCreativeFormatsRequestCreativeAgent(AdCPBaseModel):
     context: context_1.ContextObject | None = None
     ext: ext_1.ExtensionObject | None = None
     format_ids: Annotated[
-        list[format_id.FormatId] | None, Field(description="Return only these specific format IDs")
+        list[format_id.FormatId] | None, Field(description='Return only these specific format IDs')
     ] = None
     is_responsive: Annotated[
         bool | None,
         Field(
-            description="Filter for responsive formats that adapt to container size. When true, returns formats without fixed dimensions."
+            description='Filter for responsive formats that adapt to container size. When true, returns formats without fixed dimensions.'
         ),
     ] = None
     max_height: Annotated[
         int | None,
         Field(
-            description="Maximum height in pixels (inclusive). Returns formats with height <= this value. Omit for responsive/fluid formats."
+            description='Maximum height in pixels (inclusive). Returns formats with height <= this value. Omit for responsive/fluid formats.'
         ),
     ] = None
     max_width: Annotated[
         int | None,
         Field(
-            description="Maximum width in pixels (inclusive). Returns formats with width <= this value. Omit for responsive/fluid formats."
+            description='Maximum width in pixels (inclusive). Returns formats with width <= this value. Omit for responsive/fluid formats.'
         ),
     ] = None
     min_height: Annotated[
         int | None,
         Field(
-            description="Minimum height in pixels (inclusive). Returns formats with height >= this value."
+            description='Minimum height in pixels (inclusive). Returns formats with height >= this value.'
         ),
     ] = None
     min_width: Annotated[
         int | None,
         Field(
-            description="Minimum width in pixels (inclusive). Returns formats with width >= this value."
+            description='Minimum width in pixels (inclusive). Returns formats with width >= this value.'
         ),
     ] = None
     name_search: Annotated[
-        str | None, Field(description="Search for formats by name (case-insensitive partial match)")
+        str | None, Field(description='Search for formats by name (case-insensitive partial match)')
     ] = None
     type: Annotated[
         Type | None,
         Field(
-            description="Filter by format type (technical categories with distinct requirements)"
+            description='Filter by format type (technical categories with distinct requirements)'
         ),
     ] = None