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

adcp/types/generated_poc/content_standards/validate_content_delivery_request.py

@@ -0,0 +1,59 @@
+# generated by datamodel-codegen:
+#   filename:  content_standards/validate_content_delivery_request.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import AwareDatetime, Field
+
+from ..core import context as context_1
+from ..core import ext as ext_1
+from . import artifact as artifact_1
+
+
+class BrandContext(AdCPBaseModel):
+    brand_id: Annotated[str | None, Field(description='Brand identifier')] = None
+    sku_id: Annotated[str | None, Field(description='Product/SKU identifier if applicable')] = None
+
+
+class Record(AdCPBaseModel):
+    artifact: Annotated[artifact_1.Artifact, Field(description='Artifact where ad was delivered')]
+    brand_context: Annotated[
+        BrandContext | None,
+        Field(
+            description='Brand information for policy evaluation. Schema TBD - placeholder for brand identifiers.'
+        ),
+    ] = None
+    channel: Annotated[
+        str | None, Field(description='Channel type (e.g., display, video, audio, social)')
+    ] = None
+    country: Annotated[
+        str | None, Field(description='ISO 3166-1 alpha-2 country code where delivery occurred')
+    ] = None
+    media_buy_id: Annotated[
+        str | None,
+        Field(description='Media buy this record belongs to (when batching across multiple buys)'),
+    ] = None
+    record_id: Annotated[str, Field(description='Unique identifier for this delivery record')]
+    timestamp: Annotated[AwareDatetime | None, Field(description='When the delivery occurred')] = (
+        None
+    )
+
+
+class ValidateContentDeliveryRequest(AdCPBaseModel):
+    context: context_1.ContextObject | None = None
+    ext: ext_1.ExtensionObject | None = None
+    feature_ids: Annotated[
+        list[str] | None, Field(description='Specific features to evaluate (defaults to all)')
+    ] = None
+    include_passed: Annotated[
+        bool | None, Field(description='Include passed records in results')
+    ] = True
+    records: Annotated[
+        list[Record],
+        Field(description='Delivery records to validate (max 10,000)', max_length=10000),
+    ]
+    standards_id: Annotated[str, Field(description='Standards configuration to validate against')]

adcp/types/generated_poc/content_standards/validate_content_delivery_response.py

@@ -0,0 +1,85 @@
+# generated by datamodel-codegen:
+#   filename:  content_standards/validate_content_delivery_response.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from enum import Enum
+from typing import Annotated, Any
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import Field, RootModel
+
+from ..core import context as context_1
+from ..core import error
+from ..core import ext as ext_1
+
+
+class Status(Enum):
+    passed = 'passed'
+    failed = 'failed'
+    warning = 'warning'
+    unevaluated = 'unevaluated'
+
+
+class Feature(AdCPBaseModel):
+    feature_id: str
+    message: str | None = None
+    rule_id: Annotated[
+        str | None,
+        Field(
+            description='Which rule triggered this result (e.g., GARM category, Scope3 standard)'
+        ),
+    ] = None
+    status: Status
+    value: Any | None = None
+
+
+class Verdict(Enum):
+    pass_ = 'pass'
+    fail = 'fail'
+
+
+class Result(AdCPBaseModel):
+    features: Annotated[
+        list[Feature] | None, Field(description='Optional feature-level breakdown')
+    ] = None
+    record_id: Annotated[str, Field(description='Which delivery record was evaluated')]
+    verdict: Annotated[Verdict, Field(description='Overall pass/fail verdict for this record')]
+
+
+class Summary(AdCPBaseModel):
+    failed_records: int
+    passed_records: int
+    total_records: int
+
+
+class ValidateContentDeliveryResponse1(AdCPBaseModel):
+    context: context_1.ContextObject | None = None
+    errors: Annotated[
+        Any | None, Field(description='Field must not be present in success response')
+    ] = None
+    ext: ext_1.ExtensionObject | None = None
+    results: Annotated[list[Result], Field(description='Per-record evaluation results')]
+    summary: Annotated[Summary, Field(description='Summary counts across all records')]
+
+
+class ValidateContentDeliveryResponse2(AdCPBaseModel):
+    context: context_1.ContextObject | None = None
+    errors: list[error.Error]
+    ext: ext_1.ExtensionObject | None = None
+    summary: Annotated[
+        Any | None, Field(description='Field must not be present in error response')
+    ] = None
+
+
+class ValidateContentDeliveryResponse(
+    RootModel[ValidateContentDeliveryResponse1 | ValidateContentDeliveryResponse2]
+):
+    root: Annotated[
+        ValidateContentDeliveryResponse1 | ValidateContentDeliveryResponse2,
+        Field(
+            description='Response payload with per-record verdicts and optional feature breakdown',
+            title='Validate Content Delivery Response',
+        ),
+    ]

adcp/types/generated_poc/core/activation_key.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/activation_key.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/assets/audio_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/assets/audio_asset.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/assets/css_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/assets/css_asset.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/assets/daast_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/assets/daast_asset.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/assets/html_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/assets/html_asset.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/assets/image_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/assets/image_asset.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/assets/javascript_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/assets/javascript_asset.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/assets/text_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/assets/text_asset.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/assets/url_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/assets/url_asset.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/assets/vast_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/assets/vast_asset.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/assets/video_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/assets/video_asset.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/assets/webhook_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/assets/webhook_asset.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/async_response_data.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/async_response_data.json
-#   timestamp: 2025-12-11T15:09:37+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/brand_manifest.py

@@ -1,11 +1,11 @@
 # generated by datamodel-codegen:
 #   filename:  core/brand_manifest.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
 from enum import Enum
-from typing import Annotated, Any
+from typing import Annotated, Any, Literal
 
 from adcp.types.base import AdCPBaseModel
 from pydantic import AnyUrl, AwareDatetime, ConfigDict, EmailStr, Field
@@ -47,6 +47,18 @@ class Asset(AdCPBaseModel):
     width: Annotated[int | None, Field(description='Image/video width in pixels')] = None
 
 
+class Avatar(AdCPBaseModel):
+    avatar_id: Annotated[str | None, Field(description='Provider-specific avatar identifier')] = (
+        None
+    )
+    provider: Annotated[
+        str | None, Field(description="Avatar provider (e.g., 'd-id', 'heygen', 'synthesia')")
+    ] = None
+    settings: Annotated[
+        dict[str, Any] | None, Field(description='Provider-specific avatar settings')
+    ] = None
+
+
 class Colors(AdCPBaseModel):
     accent: Annotated[
         str | None, Field(description='Accent color (hex format)', pattern='^#[0-9A-Fa-f]{6}$')
@@ -115,9 +127,26 @@ class Metadata(AdCPBaseModel):
     version: Annotated[str | None, Field(description='Brand card version number')] = None
 
 
+class AgenticCheckout(AdCPBaseModel):
+    endpoint: Annotated[
+        AnyUrl,
+        Field(
+            description='Base URL for checkout session API (e.g., https://merchant.com/api/checkout_sessions)'
+        ),
+    ]
+    spec: Annotated[
+        Literal['openai_agentic_checkout_v1'],
+        Field(description='Checkout API specification implemented by the endpoint'),
+    ]
+    supported_payment_providers: Annotated[
+        list[str] | None, Field(description='Payment providers supported by this checkout endpoint')
+    ] = None
+
+
 class FeedFormat(Enum):
     google_merchant_center = 'google_merchant_center'
     facebook_catalog = 'facebook_catalog'
+    openai_product_feed = 'openai_product_feed'
     custom = 'custom'
 
 
@@ -132,13 +161,22 @@ class ProductCatalog(AdCPBaseModel):
     model_config = ConfigDict(
         extra='allow',
     )
+    agentic_checkout: Annotated[
+        AgenticCheckout | None,
+        Field(
+            description='Agentic checkout endpoint configuration. Enables AI agents to complete purchases on behalf of users through a structured checkout API.'
+        ),
+    ] = None
     categories: Annotated[
         list[str] | None,
         Field(description='Product categories available in the catalog (for filtering)'),
     ] = None
-    feed_format: Annotated[FeedFormat | None, Field(description='Format of the product feed')] = (
-        FeedFormat.google_merchant_center
-    )
+    feed_format: Annotated[
+        FeedFormat | None,
+        Field(
+            description="Format of the product feed. Use 'openai_product_feed' for feeds conforming to the OpenAI Commerce Product Feed specification."
+        ),
+    ] = FeedFormat.google_merchant_center
     feed_url: Annotated[AnyUrl, Field(description='URL to product catalog feed')]
     last_updated: Annotated[
         AwareDatetime | None, Field(description='When the product catalog was last updated')
@@ -148,6 +186,17 @@ class ProductCatalog(AdCPBaseModel):
     ] = None
 
 
+class Voice(AdCPBaseModel):
+    provider: Annotated[
+        str | None, Field(description="TTS provider (e.g., 'elevenlabs', 'openai', 'amazon_polly')")
+    ] = None
+    settings: Annotated[
+        dict[str, Any] | None,
+        Field(description='Provider-specific voice settings (speed, pitch, etc.)'),
+    ] = None
+    voice_id: Annotated[str | None, Field(description='Provider-specific voice identifier')] = None
+
+
 class BrandManifest(AdCPBaseModel):
     model_config = ConfigDict(
         extra='allow',
@@ -158,6 +207,10 @@ class BrandManifest(AdCPBaseModel):
             description='Brand asset library with explicit assets and tags. Assets are referenced inline with URLs pointing to CDN-hosted files.'
         ),
     ] = None
+    avatar: Annotated[
+        Avatar | None,
+        Field(description='Brand avatar configuration for visual conversational experiences'),
+    ] = None
     colors: Annotated[Colors | None, Field(description='Brand color palette')] = None
     contact: Annotated[Contact | None, Field(description='Brand contact information')] = None
     disclaimers: Annotated[
@@ -177,6 +230,12 @@ class BrandManifest(AdCPBaseModel):
     ] = None
     metadata: Annotated[Metadata | None, Field(description='Additional brand metadata')] = None
     name: Annotated[str, Field(description='Brand or business name')]
+    privacy_policy_url: Annotated[
+        AnyUrl | None,
+        Field(
+            description="URL to the brand's privacy policy. Used for consumer consent flows when personal data may be shared with the advertiser. AI platforms can use this to present explicit privacy choices to users before data handoff."
+        ),
+    ] = None
     product_catalog: Annotated[
         ProductCatalog | None,
         Field(
@@ -199,3 +258,7 @@ class BrandManifest(AdCPBaseModel):
             description='Primary brand URL for context and asset discovery. Creative agents can infer brand information from this URL.'
         ),
     ] = None
+    voice: Annotated[
+        Voice | None,
+        Field(description='Brand voice configuration for audio/conversational experiences'),
+    ] = None

adcp/types/generated_poc/core/brand_manifest_ref.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/brand_manifest_ref.json
-#   timestamp: 2025-12-11T15:09:37+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/context.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/context.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/creative_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/creative_asset.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -9,6 +9,7 @@ from typing import Annotated
 from adcp.types.base import AdCPBaseModel
 from pydantic import ConfigDict, Field
 
+from ..enums import creative_status
 from . import format_id as format_id_1
 from . import promoted_offerings
 from .assets import (
@@ -43,12 +44,6 @@ class CreativeAsset(AdCPBaseModel):
     model_config = ConfigDict(
         extra='allow',
     )
-    approved: Annotated[
-        bool | None,
-        Field(
-            description='For generative creatives: set to true to approve and finalize, false to request regeneration with updated assets/message. Omit for non-generative creatives.'
-        ),
-    ] = None
     assets: Annotated[
         dict[
             str,
@@ -87,6 +82,12 @@ class CreativeAsset(AdCPBaseModel):
             min_length=1,
         ),
     ] = None
+    status: Annotated[
+        creative_status.CreativeStatus | None,
+        Field(
+            description="For generative creatives: set to 'approved' to finalize, 'rejected' to request regeneration with updated assets/message. Omit for non-generative creatives (system will set based on processing state)."
+        ),
+    ] = None
     tags: Annotated[
         list[str] | None, Field(description='User-defined tags for organization and searchability')
     ] = None

adcp/types/generated_poc/core/creative_assignment.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/creative_assignment.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/creative_filters.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/creative_filters.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -16,9 +16,6 @@ class CreativeFilters(AdCPBaseModel):
     model_config = ConfigDict(
         extra='allow',
     )
-    assigned_to_package: Annotated[
-        str | None, Field(description='Filter creatives assigned to this specific package')
-    ] = None
     assigned_to_packages: Annotated[
         list[str] | None, Field(description='Filter creatives assigned to any of these packages')
     ] = None
@@ -39,12 +36,9 @@ class CreativeFilters(AdCPBaseModel):
     creative_ids: Annotated[
         list[str] | None, Field(description='Filter by specific creative IDs', max_length=100)
     ] = None
-    format: Annotated[
-        str | None,
-        Field(description='Filter by creative format type (e.g., video, audio, display)'),
-    ] = None
     formats: Annotated[
-        list[str] | None, Field(description='Filter by multiple creative format types')
+        list[str] | None,
+        Field(description='Filter by creative format types (e.g., video, audio, display)'),
     ] = None
     has_performance_data: Annotated[
         bool | None, Field(description='Filter creatives that have performance data when true')
@@ -56,13 +50,9 @@ class CreativeFilters(AdCPBaseModel):
         str | None,
         Field(description='Filter by creative names containing this text (case-insensitive)'),
     ] = None
-    status: Annotated[
-        creative_status.CreativeStatus | None,
-        Field(description='Filter by creative approval status'),
-    ] = None
     statuses: Annotated[
         list[creative_status.CreativeStatus] | None,
-        Field(description='Filter by multiple creative statuses'),
+        Field(description='Filter by creative approval statuses'),
     ] = None
     tags: Annotated[
         list[str] | None, Field(description='Filter by creative tags (all tags must match)')

adcp/types/generated_poc/core/creative_manifest.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/creative_manifest.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/creative_policy.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/creative_policy.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/delivery_metrics.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/delivery_metrics.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/deployment.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/deployment.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/destination.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/destination.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/error.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/error.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/ext.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/ext.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/format.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/format.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -66,7 +66,7 @@ class Asset(AdCPBaseModel):
     ] = None
 
 
-class Assets1(AdCPBaseModel):
+class Assets5(AdCPBaseModel):
     asset_group_id: Annotated[
         str, Field(description="Identifier for this asset group (e.g., 'product', 'slide', 'card')")
     ]
@@ -203,7 +203,8 @@ class Renders(AdCPBaseModel):
     ]
 
 
-Dimensions1 = Dimensions
+class Dimensions1(Dimensions):
+    pass
 
 
 class Renders1(AdCPBaseModel):
@@ -269,7 +270,7 @@ class Format(AdCPBaseModel):
         ),
     ] = None
     assets: Annotated[
-        list[Assets | Assets1] | None,
+        list[Assets | Assets5] | 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."
         ),
@@ -278,7 +279,7 @@ class Format(AdCPBaseModel):
         list[AssetsRequired | AssetsRequired1] | None,
         Field(
             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."
+            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: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/frequency_cap.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/frequency_cap.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations