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

adcp/types/generated_poc/core/protocol_envelope.py

@@ -15,47 +15,47 @@ from . import push_notification_config as push_notification_config_1
 
 class ProtocolEnvelope(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     context_id: Annotated[
         str | None,
         Field(
-            description='Session/conversation identifier for tracking related operations across multiple task invocations. Managed by the protocol layer to maintain conversational context.'
+            description="Session/conversation identifier for tracking related operations across multiple task invocations. Managed by the protocol layer to maintain conversational context."
         ),
     ] = None
     message: Annotated[
         str | None,
         Field(
-            description='Human-readable summary of the task result. Provides natural language explanation of what happened, suitable for display to end users or for AI agent comprehension. Generated by the protocol layer based on the task response.'
+            description="Human-readable summary of the task result. Provides natural language explanation of what happened, suitable for display to end users or for AI agent comprehension. Generated by the protocol layer based on the task response."
         ),
     ] = None
     payload: Annotated[
         dict[str, Any],
         Field(
-            description='The actual task-specific response data. This is the content defined in individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Contains only domain-specific data without protocol-level fields.'
+            description="The actual task-specific response data. This is the content defined in individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). Contains only domain-specific data without protocol-level fields."
         ),
     ]
     push_notification_config: Annotated[
         push_notification_config_1.PushNotificationConfig | None,
         Field(
-            description='Push notification configuration for async task updates (A2A and REST protocols). Echoed from the request to confirm webhook settings. Specifies URL, authentication scheme (Bearer or HMAC-SHA256), and credentials. MCP uses progress notifications instead of webhooks.'
+            description="Push notification configuration for async task updates (A2A and REST protocols). Echoed from the request to confirm webhook settings. Specifies URL, authentication scheme (Bearer or HMAC-SHA256), and credentials. MCP uses progress notifications instead of webhooks."
         ),
     ] = None
     status: Annotated[
         task_status.TaskStatus,
         Field(
-            description='Current task execution state. Indicates whether the task is completed, in progress (working), submitted for async processing, failed, or requires user input. Managed by the protocol layer.'
+            description="Current task execution state. Indicates whether the task is completed, in progress (working), submitted for async processing, failed, or requires user input. Managed by the protocol layer."
         ),
     ]
     task_id: Annotated[
         str | None,
         Field(
-            description='Unique identifier for tracking asynchronous operations. Present when a task requires extended processing time. Used to query task status and retrieve results when complete.'
+            description="Unique identifier for tracking asynchronous operations. Present when a task requires extended processing time. Used to query task status and retrieve results when complete."
         ),
     ] = None
     timestamp: Annotated[
         AwareDatetime | None,
         Field(
-            description='ISO 8601 timestamp when the response was generated. Useful for debugging, logging, cache validation, and tracking async operation progress.'
+            description="ISO 8601 timestamp when the response was generated. Useful for debugging, logging, cache validation, and tracking async operation progress."
         ),
     ] = None

adcp/types/generated_poc/core/publisher_property_selector.py

@@ -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

@@ -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

@@ -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/response.py

@@ -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

@@ -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,18 +1,18 @@
 # generated by datamodel-codegen:
 #   filename:  core/start_timing.json
-#   timestamp: 2025-12-11T15:09:37+00:00
+#   timestamp: 2026-01-14T17:08:13+00:00
 
 from __future__ import annotations
 
-from typing import Annotated
+from typing import Annotated, Literal
 
 from pydantic import AwareDatetime, Field, RootModel
 
 
-class StartTiming(RootModel[str | AwareDatetime]):
+class StartTiming(RootModel[Literal["asap"] | AwareDatetime]):
     root: Annotated[
-        str | 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

@@ -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

@@ -13,41 +13,41 @@ from . import frequency_cap as frequency_cap_1
 
 
 class GeoCountryAnyOfItem(RootModel[str]):
-    root: Annotated[str, Field(pattern='^[A-Z]{2}$')]
+    root: Annotated[str, Field(pattern="^[A-Z]{2}$")]
 
 
 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,
         Field(
-            description='Restrict delivery to specific countries (ISO codes). Use for regulatory compliance or RCT testing.'
+            description="Restrict delivery to specific countries (ISO codes). Use for regulatory compliance or RCT testing."
         ),
     ] = None
     geo_metro_any_of: Annotated[
         list[str] | 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 (DMA codes). Use for regulatory compliance or RCT testing."
         ),
     ] = None
     geo_postal_code_any_of: Annotated[
         list[str] | None,
         Field(
-            description='Restrict delivery to specific postal/ZIP codes. Use for regulatory compliance or RCT testing.'
+            description="Restrict delivery to specific postal/ZIP codes. Use for regulatory compliance or RCT testing."
         ),
     ] = None
     geo_region_any_of: Annotated[
         list[str] | None,
         Field(
-            description='Restrict delivery to specific regions/states. Use for regulatory compliance or RCT testing.'
+            description="Restrict delivery to specific regions/states. Use for regulatory compliance or RCT testing."
         ),
     ] = None

adcp/types/generated_poc/creative/list_creative_formats_request.py

@@ -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

adcp/types/generated_poc/creative/list_creative_formats_response.py

@@ -18,7 +18,7 @@ from ..enums import creative_agent_capability
 
 class CreativeAgent(AdCPBaseModel):
     agent_name: Annotated[
-        str | None, Field(description='Human-readable name for the creative agent')
+        str | None, Field(description="Human-readable name for the creative agent")
     ] = None
     agent_url: Annotated[
         AnyUrl,
@@ -28,23 +28,23 @@ class CreativeAgent(AdCPBaseModel):
     ]
     capabilities: Annotated[
         list[creative_agent_capability.CreativeAgentCapability] | None,
-        Field(description='Capabilities this creative agent provides'),
+        Field(description="Capabilities this creative agent provides"),
     ] = None
 
 
 class ListCreativeFormatsResponseCreativeAgent(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     context: context_1.ContextObject | None = None
     creative_agents: Annotated[
         list[CreativeAgent] | None,
         Field(
-            description='Optional: Creative agents that provide additional formats. Buyers can recursively query these agents to discover more formats. No authentication required for list_creative_formats.'
+            description="Optional: Creative agents that provide additional formats. Buyers can recursively query these agents to discover more formats. No authentication required for list_creative_formats."
         ),
     ] = None
     errors: Annotated[
-        list[error.Error] | None, Field(description='Task-specific errors and warnings')
+        list[error.Error] | None, Field(description="Task-specific errors and warnings")
     ] = None
     ext: ext_1.ExtensionObject | None = None
     formats: Annotated[