adcp 2.2.0__py3-none-any.whl → 2.4.0__py3-none-any.whl

adcp/types/generated_poc/pricing_model.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  pricing-model.json
-#   timestamp: 2025-11-15T22:03:55+00:00
+#   timestamp: 2025-11-18T03:04:10+00:00
 
 from __future__ import annotations
 
@@ -8,10 +8,10 @@ from enum import Enum
 
 
 class PricingModel(Enum):
-    cpm = "cpm"
-    vcpm = "vcpm"
-    cpc = "cpc"
-    cpcv = "cpcv"
-    cpv = "cpv"
-    cpp = "cpp"
-    flat_rate = "flat_rate"
+    cpm = 'cpm'
+    vcpm = 'vcpm'
+    cpc = 'cpc'
+    cpcv = 'cpcv'
+    cpv = 'cpv'
+    cpp = 'cpp'
+    flat_rate = 'flat_rate'

adcp/types/generated_poc/product.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  product.json
-#   timestamp: 2025-11-15T22:03:55+00:00
+#   timestamp: 2025-11-18T03:04:10+00:00
 
 from __future__ import annotations
 
@@ -37,45 +37,45 @@ class DeliveryMeasurement(AdCPBaseModel):
 
 class ProductCard(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="forbid",
+        extra='forbid',
     )
     format_id: Annotated[
         format_id_1.FormatId,
         Field(
-            description="Creative format defining the card layout (typically product_card_standard)"
+            description='Creative format defining the card layout (typically product_card_standard)'
         ),
     ]
     manifest: Annotated[
         dict[str, Any],
-        Field(description="Asset manifest for rendering the card, structure defined by the format"),
+        Field(description='Asset manifest for rendering the card, structure defined by the format'),
     ]
 
 
 class ProductCardDetailed(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="forbid",
+        extra='forbid',
     )
     format_id: Annotated[
         format_id_1.FormatId,
         Field(
-            description="Creative format defining the detailed card layout (typically product_card_detailed)"
+            description='Creative format defining the detailed card layout (typically product_card_detailed)'
         ),
     ]
     manifest: Annotated[
         dict[str, Any],
         Field(
-            description="Asset manifest for rendering the detailed card, structure defined by the format"
+            description='Asset manifest for rendering the detailed card, structure defined by the format'
         ),
     ]
 
 
 class PropertyId(RootModel[str]):
-    root: Annotated[str, Field(pattern="^[a-z0-9_]+$")]
+    root: Annotated[str, Field(pattern='^[a-z0-9_]+$')]
 
 
 class PublisherProperties(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="forbid",
+        extra='forbid',
     )
     property_ids: Annotated[
         list[PropertyId],
@@ -85,12 +85,12 @@ class PublisherProperties(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'),
     ]
 
 
@@ -100,7 +100,7 @@ class PropertyTag(PropertyId):
 
 class PublisherProperties3(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="forbid",
+        extra='forbid',
     )
     property_tags: Annotated[
         list[PropertyTag],
@@ -113,55 +113,55 @@ class PublisherProperties3(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')
     ]
 
 
 class Product(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="forbid",
+        extra='forbid',
     )
     brief_relevance: Annotated[
         str | None,
         Field(
-            description="Explanation of why this product matches the brief (only included when brief is provided)"
+            description='Explanation of why this product matches the brief (only included when brief is provided)'
         ),
     ] = None
     creative_policy: creative_policy_1.CreativePolicy | None = None
     delivery_measurement: Annotated[
         DeliveryMeasurement,
         Field(
-            description="Measurement provider and methodology for delivery metrics. The buyer accepts the declared provider as the source of truth for the buy. REQUIRED for all products."
+            description='Measurement provider and methodology for delivery metrics. The buyer accepts the declared provider as the source of truth for the buy. REQUIRED for all products.'
         ),
     ]
     delivery_type: delivery_type_1.DeliveryType
     description: Annotated[
-        str, Field(description="Detailed description of the product and its inventory")
+        str, Field(description='Detailed description of the product and its inventory')
     ]
     estimated_exposures: Annotated[
         int | None,
-        Field(description="Estimated exposures/impressions for guaranteed products", ge=0),
+        Field(description='Estimated exposures/impressions for guaranteed products', ge=0),
     ] = None
     expires_at: Annotated[
-        AwareDatetime | None, Field(description="Expiration timestamp for custom products")
+        AwareDatetime | None, Field(description='Expiration timestamp for custom products')
     ] = None
     format_ids: Annotated[
         list[format_id_1.FormatId],
         Field(
-            description="Array of supported creative format IDs - structured format_id objects with agent_url and id"
+            description='Array of supported creative format IDs - structured format_id objects with agent_url and id'
         ),
     ]
-    is_custom: Annotated[bool | None, Field(description="Whether this is a custom product")] = None
+    is_custom: Annotated[bool | None, Field(description='Whether this is a custom product')] = None
     measurement: measurement_1.Measurement | None = None
-    name: Annotated[str, Field(description="Human-readable product name")]
+    name: Annotated[str, Field(description='Human-readable product name')]
     placements: Annotated[
         list[placement.Placement] | None,
         Field(
-            description="Optional array of specific placements within this product. When provided, buyers can target specific placements when assigning creatives.",
+            description='Optional array of specific placements within this product. When provided, buyers can target specific placements when assigning creatives.',
             min_length=1,
         ),
     ] = None
@@ -177,21 +177,21 @@ class Product(AdCPBaseModel):
             | cpp_option.CppPricingOption
             | flat_rate_option.FlatRatePricingOption
         ],
-        Field(description="Available pricing models for this product", min_length=1),
+        Field(description='Available pricing models for this product', min_length=1),
     ]
     product_card: Annotated[
         ProductCard | None,
         Field(
-            description="Optional standard visual card (300x400px) for displaying this product in user interfaces. Can be rendered via preview_creative or pre-generated."
+            description='Optional standard visual card (300x400px) for displaying this product in user interfaces. Can be rendered via preview_creative or pre-generated.'
         ),
     ] = None
     product_card_detailed: Annotated[
         ProductCardDetailed | None,
         Field(
-            description="Optional detailed card with carousel and full specifications. Provides rich product presentation similar to media kit pages."
+            description='Optional detailed card with carousel and full specifications. Provides rich product presentation similar to media kit pages.'
         ),
     ] = None
-    product_id: Annotated[str, Field(description="Unique identifier for the product")]
+    product_id: Annotated[str, Field(description='Unique identifier for the product')]
     publisher_properties: Annotated[
         list[PublisherProperties | PublisherProperties3],
         Field(
@@ -201,8 +201,9 @@ class Product(AdCPBaseModel):
     ]
     reporting_capabilities: reporting_capabilities_1.ReportingCapabilities | None = None
 
-    @model_validator(mode="after")
-    def validate_publisher_properties_items(self) -> "Product":
+
+    @model_validator(mode='after')
+    def validate_publisher_properties_items(self) -> 'Product':
         """Validate all publisher_properties items."""
         from adcp.validation import validate_product
 

adcp/types/generated_poc/promoted_offerings.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  promoted-offerings.json
-#   timestamp: 2025-11-15T22:03:55+00:00
+#   timestamp: 2025-11-18T03:04:10+00:00
 
 from __future__ import annotations
 
@@ -15,28 +15,28 @@ from . import promoted_products
 
 
 class AssetType(Enum):
-    image = "image"
-    video = "video"
-    audio = "audio"
-    vast = "vast"
-    daast = "daast"
-    text = "text"
-    url = "url"
-    html = "html"
-    css = "css"
-    javascript = "javascript"
-    webhook = "webhook"
+    image = 'image'
+    video = 'video'
+    audio = 'audio'
+    vast = 'vast'
+    daast = 'daast'
+    text = 'text'
+    url = 'url'
+    html = 'html'
+    css = 'css'
+    javascript = 'javascript'
+    webhook = 'webhook'
 
 
 class AssetSelectors(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="forbid",
+        extra='forbid',
     )
     asset_types: Annotated[
         list[AssetType] | None, Field(description="Filter by asset type (e.g., ['image', 'video'])")
     ] = None
     exclude_tags: Annotated[
-        list[str] | None, Field(description="Exclude assets with these tags")
+        list[str] | None, Field(description='Exclude assets with these tags')
     ] = None
     tags: Annotated[
         list[str] | None,
@@ -46,10 +46,10 @@ class AssetSelectors(AdCPBaseModel):
 
 class Offering(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="forbid",
+        extra='forbid',
     )
     assets: Annotated[
-        list[dict[str, Any]] | None, Field(description="Assets specific to this offering")
+        list[dict[str, Any]] | None, Field(description='Assets specific to this offering')
     ] = None
     description: Annotated[str | None, Field(description="Description of what's being offered")] = (
         None
@@ -61,42 +61,42 @@ class Offering(AdCPBaseModel):
 
 class PromotedOfferings(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="forbid",
+        extra='forbid',
     )
     asset_selectors: Annotated[
         AssetSelectors | None,
-        Field(description="Selectors to choose specific assets from the brand manifest"),
+        Field(description='Selectors to choose specific assets from the brand manifest'),
     ] = None
     brand_manifest: Annotated[
         brand_manifest_1.BrandManifest | AnyUrl,
         Field(
-            description="Brand information manifest containing assets, themes, and guidelines. Can be provided inline or as a URL reference to a hosted manifest.",
+            description='Brand information manifest containing assets, themes, and guidelines. Can be provided inline or as a URL reference to a hosted manifest.',
             examples=[
                 {
-                    "data": {
-                        "colors": {"primary": "#FF6B35"},
-                        "name": "ACME Corporation",
-                        "url": "https://acmecorp.com",
+                    'data': {
+                        'colors': {'primary': '#FF6B35'},
+                        'name': 'ACME Corporation',
+                        'url': 'https://acmecorp.com',
                     },
-                    "description": "Inline brand manifest",
+                    'description': 'Inline brand manifest',
                 },
                 {
-                    "data": "https://cdn.acmecorp.com/brand-manifest.json",
-                    "description": "URL string reference to hosted manifest",
+                    'data': 'https://cdn.acmecorp.com/brand-manifest.json',
+                    'description': 'URL string reference to hosted manifest',
                 },
             ],
-            title="Brand Manifest Reference",
+            title='Brand Manifest Reference',
         ),
     ]
     offerings: Annotated[
         list[Offering] | None,
         Field(
-            description="Inline offerings for campaigns without a product catalog. Each offering has a name, description, and associated assets."
+            description='Inline offerings for campaigns without a product catalog. Each offering has a name, description, and associated assets.'
         ),
     ] = None
     product_selectors: Annotated[
         promoted_products.PromotedProducts | None,
         Field(
-            description="Selectors to choose which products/offerings from the brand manifest product catalog to promote"
+            description='Selectors to choose which products/offerings from the brand manifest product catalog to promote'
         ),
     ] = None

adcp/types/generated_poc/promoted_products.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  promoted-products.json
-#   timestamp: 2025-11-15T22:03:55+00:00
+#   timestamp: 2025-11-18T03:04:10+00:00
 
 from __future__ import annotations
 
@@ -12,7 +12,7 @@ from pydantic import ConfigDict, Field
 
 class PromotedProducts(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="forbid",
+        extra='forbid',
     )
     manifest_category: Annotated[
         str | None,
@@ -28,7 +28,7 @@ class PromotedProducts(AdCPBaseModel):
     ] = None
     manifest_skus: Annotated[
         list[str] | None,
-        Field(description="Direct product SKU references from the brand manifest product catalog"),
+        Field(description='Direct product SKU references from the brand manifest product catalog'),
     ] = None
     manifest_tags: Annotated[
         list[str] | None,

adcp/types/generated_poc/property.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  property.json
-#   timestamp: 2025-11-15T22:03:55+00:00
+#   timestamp: 2025-11-18T03:04:10+00:00
 
 from __future__ import annotations
 
@@ -15,11 +15,11 @@ from . import identifier_types
 
 class Identifier(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="forbid",
+        extra='forbid',
     )
     type: Annotated[
         identifier_types.PropertyIdentifierTypes,
-        Field(description="Type of identifier for this property"),
+        Field(description='Type of identifier for this property'),
     ]
     value: Annotated[
         str,
@@ -30,13 +30,13 @@ class Identifier(AdCPBaseModel):
 
 
 class PropertyType(Enum):
-    website = "website"
-    mobile_app = "mobile_app"
-    ctv_app = "ctv_app"
-    dooh = "dooh"
-    podcast = "podcast"
-    radio = "radio"
-    streaming_audio = "streaming_audio"
+    website = 'website'
+    mobile_app = 'mobile_app'
+    ctv_app = 'ctv_app'
+    dooh = 'dooh'
+    podcast = 'podcast'
+    radio = 'radio'
+    streaming_audio = 'streaming_audio'
 
 
 class Tag(RootModel[str]):
@@ -44,36 +44,36 @@ class Tag(RootModel[str]):
         str,
         Field(
             description="Lowercase tag with underscores (e.g., 'conde_nast_network', 'premium_content')",
-            pattern="^[a-z0-9_]+$",
+            pattern='^[a-z0-9_]+$',
         ),
     ]
 
 
 class Property(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="forbid",
+        extra='forbid',
     )
     identifiers: Annotated[
-        list[Identifier], Field(description="Array of identifiers for this property", min_length=1)
+        list[Identifier], Field(description='Array of identifiers for this property', min_length=1)
     ]
-    name: Annotated[str, Field(description="Human-readable property name")]
+    name: Annotated[str, Field(description='Human-readable property name')]
     property_id: Annotated[
         str | None,
         Field(
             description="Unique identifier for this property (optional). Enables referencing properties by ID instead of repeating full objects. Recommended format: lowercase with underscores (e.g., 'cnn_ctv_app', 'instagram_mobile')",
-            pattern="^[a-z0-9_]+$",
+            pattern='^[a-z0-9_]+$',
         ),
     ] = None
-    property_type: Annotated[PropertyType, Field(description="Type of advertising property")]
+    property_type: Annotated[PropertyType, Field(description='Type of advertising property')]
     publisher_domain: Annotated[
         str | None,
         Field(
-            description="Domain where adagents.json should be checked for authorization validation. Required for list_authorized_properties response. Optional in adagents.json (file location implies domain)."
+            description='Domain where adagents.json should be checked for authorization validation. Required for list_authorized_properties response. Optional in adagents.json (file location implies domain).'
         ),
     ] = None
     tags: Annotated[
         list[Tag] | None,
         Field(
-            description="Tags for categorization and grouping (e.g., network membership, content categories)"
+            description='Tags for categorization and grouping (e.g., network membership, content categories)'
         ),
     ] = None

adcp/types/generated_poc/protocol_envelope.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  protocol-envelope.json
-#   timestamp: 2025-11-15T22:03:55+00:00
+#   timestamp: 2025-11-18T03:04:10+00:00
 
 from __future__ import annotations
 
@@ -15,47 +15,47 @@ from . import task_status
 
 class ProtocolEnvelope(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="forbid",
+        extra='forbid',
     )
     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/provide_performance_feedback_request.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  provide-performance-feedback-request.json
-#   timestamp: 2025-11-15T22:03:55+00:00
+#   timestamp: 2025-11-18T03:04:10+00:00
 
 from __future__ import annotations
 
@@ -12,74 +12,74 @@ from pydantic import AwareDatetime, ConfigDict, Field
 
 
 class FeedbackSource(Enum):
-    buyer_attribution = "buyer_attribution"
-    third_party_measurement = "third_party_measurement"
-    platform_analytics = "platform_analytics"
-    verification_partner = "verification_partner"
+    buyer_attribution = 'buyer_attribution'
+    third_party_measurement = 'third_party_measurement'
+    platform_analytics = 'platform_analytics'
+    verification_partner = 'verification_partner'
 
 
 class MeasurementPeriod(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="forbid",
+        extra='forbid',
     )
     end: Annotated[
-        AwareDatetime, Field(description="ISO 8601 end timestamp for measurement period")
+        AwareDatetime, Field(description='ISO 8601 end timestamp for measurement period')
     ]
     start: Annotated[
-        AwareDatetime, Field(description="ISO 8601 start timestamp for measurement period")
+        AwareDatetime, Field(description='ISO 8601 start timestamp for measurement period')
     ]
 
 
 class MetricType(Enum):
-    overall_performance = "overall_performance"
-    conversion_rate = "conversion_rate"
-    brand_lift = "brand_lift"
-    click_through_rate = "click_through_rate"
-    completion_rate = "completion_rate"
-    viewability = "viewability"
-    brand_safety = "brand_safety"
-    cost_efficiency = "cost_efficiency"
+    overall_performance = 'overall_performance'
+    conversion_rate = 'conversion_rate'
+    brand_lift = 'brand_lift'
+    click_through_rate = 'click_through_rate'
+    completion_rate = 'completion_rate'
+    viewability = 'viewability'
+    brand_safety = 'brand_safety'
+    cost_efficiency = 'cost_efficiency'
 
 
 class ProvidePerformanceFeedbackRequest(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="forbid",
+        extra='forbid',
     )
     context: Annotated[
         dict[str, Any] | None,
         Field(
-            description="Initiator-provided context included in the request payload. Agentsmust echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata."
+            description='Initiator-provided context included in the request payload. Agentsmust echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.'
         ),
     ] = None
     creative_id: Annotated[
         str | None,
         Field(
-            description="Specific creative asset (if feedback is creative-specific)", min_length=1
+            description='Specific creative asset (if feedback is creative-specific)', min_length=1
         ),
     ] = None
     feedback_source: Annotated[
-        FeedbackSource | None, Field(description="Source of the performance data")
+        FeedbackSource | None, Field(description='Source of the performance data')
     ] = FeedbackSource.buyer_attribution
     measurement_period: Annotated[
-        MeasurementPeriod, Field(description="Time period for performance measurement")
+        MeasurementPeriod, Field(description='Time period for performance measurement')
     ]
     media_buy_id: Annotated[
         str, Field(description="Publisher's media buy identifier", min_length=1)
     ]
     metric_type: Annotated[
-        MetricType | None, Field(description="The business metric being measured")
+        MetricType | None, Field(description='The business metric being measured')
     ] = MetricType.overall_performance
     package_id: Annotated[
         str | None,
         Field(
-            description="Specific package within the media buy (if feedback is package-specific)",
+            description='Specific package within the media buy (if feedback is package-specific)',
             min_length=1,
         ),
     ] = None
     performance_index: Annotated[
         float,
         Field(
-            description="Normalized performance score (0.0 = no value, 1.0 = expected, >1.0 = above expected)",
+            description='Normalized performance score (0.0 = no value, 1.0 = expected, >1.0 = above expected)',
             ge=0.0,
         ),
     ]