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

adcp/types/generated_poc/extensions/extension_meta.py

@@ -0,0 +1,50 @@
+# generated by datamodel-codegen:
+#   filename:  extensions/extension_meta.json
+#   timestamp: 2026-01-14T17:08:13+00:00
+
+from __future__ import annotations
+
+from typing import Annotated, Any, Literal
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import AnyUrl, Field
+
+
+class AdcpExtensionFileSchema(AdCPBaseModel):
+    field_schema: Annotated[
+        Literal["http://json-schema.org/draft-07/schema#"], Field(alias="$schema")
+    ]
+    additionalProperties: Annotated[
+        Any | None,
+        Field(description="Whether additional properties are allowed in the extension data"),
+    ] = None
+    description: Annotated[str, Field(description="Description of what this extension provides")]
+    docs_url: Annotated[
+        AnyUrl | None, Field(description="URL to documentation for implementors of this extension")
+    ] = None
+    properties: Annotated[
+        dict[str, Any],
+        Field(description="Schema properties defining the structure of ext.{namespace} data"),
+    ]
+    required: Annotated[
+        list[str] | None, Field(description="Required properties within the extension data")
+    ] = None
+    title: Annotated[str, Field(description="Human-readable title for the extension")]
+    type: Annotated[
+        Literal["object"],
+        Field(description="Extensions must be objects (data within ext.{namespace})"),
+    ]
+    valid_from: Annotated[
+        str,
+        Field(
+            description="Minimum AdCP version this extension is compatible with (e.g., '2.5'). Extension will be included in all versioned schema builds >= this version.",
+            pattern="^\\d+\\.\\d+$",
+        ),
+    ]
+    valid_until: Annotated[
+        str | None,
+        Field(
+            description="Last AdCP version this extension is compatible with (e.g., '3.0'). Omit if extension is still valid for current and future versions.",
+            pattern="^\\d+\\.\\d+$",
+        ),
+    ] = None

adcp/types/generated_poc/media_buy/build_creative_request.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  media_buy/build_creative_request.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -17,25 +17,25 @@ from ..core import format_id
 
 class BuildCreativeRequest(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra="allow",
     )
     context: context_1.ContextObject | None = None
     creative_manifest: Annotated[
         creative_manifest_1.CreativeManifest | None,
         Field(
-            description='Creative manifest to transform or generate from. For pure generation, this should include the target format_id and any required input assets (e.g., promoted_offerings for generative formats). For transformation (e.g., resizing, reformatting), this is the complete creative to adapt.'
+            description="Creative manifest to transform or generate from. For pure generation, this should include the target format_id and any required input assets (e.g., promoted_offerings for generative formats). For transformation (e.g., resizing, reformatting), this is the complete creative to adapt."
         ),
     ] = None
     ext: ext_1.ExtensionObject | None = None
     message: Annotated[
         str | None,
         Field(
-            description='Natural language instructions for the transformation or generation. For pure generation, this is the creative brief. For transformation, this provides guidance on how to adapt the creative.'
+            description="Natural language instructions for the transformation or generation. For pure generation, this is the creative brief. For transformation, this provides guidance on how to adapt the creative."
         ),
     ] = None
     target_format_id: Annotated[
         format_id.FormatId,
         Field(
-            description='Format ID to generate. The format definition specifies required input assets and output structure.'
+            description="Format ID to generate. The format definition specifies required input assets and output structure."
         ),
     ]

adcp/types/generated_poc/media_buy/build_creative_response.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  media_buy/build_creative_response.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -17,13 +17,13 @@ from ..core import ext as ext_1
 
 class BuildCreativeResponse2(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra="allow",
     )
     context: context_1.ContextObject | None = None
     errors: Annotated[
         list[error.Error],
         Field(
-            description='Array of errors explaining why creative generation failed', min_length=1
+            description="Array of errors explaining why creative generation failed", min_length=1
         ),
     ]
     ext: ext_1.ExtensionObject | None = None
@@ -31,12 +31,12 @@ class BuildCreativeResponse2(AdCPBaseModel):
 
 class BuildCreativeResponse1(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra="allow",
     )
     context: context_1.ContextObject | None = None
     creative_manifest: Annotated[
         creative_manifest_1.CreativeManifest,
-        Field(description='The generated or transformed creative manifest'),
+        Field(description="The generated or transformed creative manifest"),
     ]
     ext: ext_1.ExtensionObject | None = None
 
@@ -45,7 +45,7 @@ class BuildCreativeResponse(RootModel[BuildCreativeResponse1 | BuildCreativeResp
     root: Annotated[
         BuildCreativeResponse1 | BuildCreativeResponse2,
         Field(
-            description='Response containing the transformed or generated creative manifest, ready for use with preview_creative or sync_creatives. Returns either the complete creative manifest OR error information, never both.',
-            title='Build Creative Response',
+            description="Response containing the transformed or generated creative manifest, ready for use with preview_creative or sync_creatives. Returns either the complete creative manifest OR error information, never both.",
+            title="Build Creative Response",
         ),
     ]

adcp/types/generated_poc/media_buy/create_media_buy_async_response_input_required.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  media_buy/create_media_buy_async_response_input_required.json
-#   timestamp: 2025-12-11T15:09:37+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -16,22 +16,22 @@ from ..core import ext as ext_1
 
 
 class Reason(Enum):
-    APPROVAL_REQUIRED = 'APPROVAL_REQUIRED'
-    BUDGET_EXCEEDS_LIMIT = 'BUDGET_EXCEEDS_LIMIT'
+    APPROVAL_REQUIRED = "APPROVAL_REQUIRED"
+    BUDGET_EXCEEDS_LIMIT = "BUDGET_EXCEEDS_LIMIT"
 
 
 class CreateMediaBuyInputRequired(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra="allow",
     )
     context: context_1.ContextObject | None = None
     errors: Annotated[
         list[error.Error] | None,
         Field(
-            description='Optional validation errors or warnings for debugging purposes. Helps explain why input is required.'
+            description="Optional validation errors or warnings for debugging purposes. Helps explain why input is required."
         ),
     ] = None
     ext: ext_1.ExtensionObject | None = None
     reason: Annotated[
-        Reason | None, Field(description='Reason code indicating why input is needed')
+        Reason | None, Field(description="Reason code indicating why input is needed")
     ] = None

adcp/types/generated_poc/media_buy/create_media_buy_async_response_submitted.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  media_buy/create_media_buy_async_response_submitted.json
-#   timestamp: 2025-12-11T15:09:37+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -13,7 +13,7 @@ from ..core import ext as ext_1
 
 class CreateMediaBuySubmitted(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra="allow",
     )
     context: context_1.ContextObject | None = None
     ext: ext_1.ExtensionObject | None = None

adcp/types/generated_poc/media_buy/create_media_buy_async_response_working.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  media_buy/create_media_buy_async_response_working.json
-#   timestamp: 2025-12-11T15:09:37+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -15,17 +15,17 @@ from ..core import ext as ext_1
 
 class CreateMediaBuyWorking(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra="allow",
     )
     context: context_1.ContextObject | None = None
     current_step: Annotated[
-        str | None, Field(description='Current step or phase of the operation')
+        str | None, Field(description="Current step or phase of the operation")
     ] = None
     ext: ext_1.ExtensionObject | None = None
     percentage: Annotated[
-        float | None, Field(description='Completion percentage (0-100)', ge=0.0, le=100.0)
+        float | None, Field(description="Completion percentage (0-100)", ge=0.0, le=100.0)
     ] = None
-    step_number: Annotated[int | None, Field(description='Current step number', ge=1)] = None
+    step_number: Annotated[int | None, Field(description="Current step number", ge=1)] = None
     total_steps: Annotated[
-        int | None, Field(description='Total number of steps in the operation', ge=1)
+        int | None, Field(description="Total number of steps in the operation", ge=1)
     ] = None

adcp/types/generated_poc/media_buy/create_media_buy_request.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  media_buy/create_media_buy_request.json
-#   timestamp: 2025-12-11T15:09:37+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -8,39 +8,67 @@ from enum import Enum
 from typing import Annotated
 
 from adcp.types.base import AdCPBaseModel
-from pydantic import AwareDatetime, ConfigDict, Field
+from pydantic import AnyUrl, AwareDatetime, ConfigDict, Field
 
 from ..core import brand_manifest_ref
 from ..core import context as context_1
 from ..core import ext as ext_1
 from ..core import start_timing
-from ..core.push_notification_config import PushNotificationConfig
+from ..enums import auth_scheme
 from . import package_request
 
 
+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'
+    hourly = "hourly"
+    daily = "daily"
+    monthly = "monthly"
 
 
 class RequestedMetric(Enum):
-    impressions = 'impressions'
-    spend = 'spend'
-    clicks = 'clicks'
-    ctr = 'ctr'
-    video_completions = 'video_completions'
-    completion_rate = 'completion_rate'
-    conversions = 'conversions'
-    viewability = 'viewability'
-    engagement_rate = 'engagement_rate'
+    impressions = "impressions"
+    spend = "spend"
+    clicks = "clicks"
+    ctr = "ctr"
+    video_completions = "video_completions"
+    completion_rate = "completion_rate"
+    conversions = "conversions"
+    viewability = "viewability"
+    engagement_rate = "engagement_rate"
 
 
-class ReportingWebhook(PushNotificationConfig):
+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.'
+            description="Frequency for automated reporting delivery. Must be supported by all products in the media buy."
         ),
     ]
     requested_metrics: Annotated[
@@ -49,27 +77,40 @@ class ReportingWebhook(PushNotificationConfig):
             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")]
 
 
 class CreateMediaBuyRequest(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra="allow",
     )
     brand_manifest: Annotated[
         brand_manifest_ref.BrandManifestReference,
         Field(
-            description='Brand information manifest serving as the namespace and identity for this media buy. Provides brand context, assets, and product catalog. Can be provided inline or as a URL reference to a hosted manifest. Can be cached and reused across multiple requests.'
+            description="Brand information manifest serving as the namespace and identity for this media buy. Provides brand context, assets, and product catalog. Can be provided inline or as a URL reference to a hosted manifest. Can be cached and reused across multiple requests."
         ),
     ]
     buyer_ref: Annotated[str, Field(description="Buyer's reference identifier for this media buy")]
     context: context_1.ContextObject | None = None
     end_time: Annotated[
-        AwareDatetime, Field(description='Campaign end date/time in ISO 8601 format')
+        AwareDatetime, Field(description="Campaign end date/time in ISO 8601 format")
     ]
     ext: ext_1.ExtensionObject | None = None
     packages: Annotated[
-        list[package_request.PackageRequest], Field(description='Array of package configurations')
+        list[package_request.PackageRequest], Field(description="Array of package configurations")
     ]
-    po_number: Annotated[str | None, Field(description='Purchase order number for tracking')] = None
-    reporting_webhook: ReportingWebhook | None = None
+    po_number: Annotated[str | None, Field(description="Purchase order number for tracking")] = None
+    reporting_webhook: Annotated[
+        ReportingWebhook | None,
+        Field(
+            description="Optional webhook configuration for automated reporting delivery. Combines push_notification_config structure with reporting-specific fields."
+        ),
+    ] = None
     start_time: start_timing.StartTiming

adcp/types/generated_poc/media_buy/create_media_buy_response.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  media_buy/create_media_buy_response.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -17,24 +17,24 @@ from ..core import package
 
 class CreateMediaBuyResponse2(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra="allow",
     )
     context: context_1.ContextObject | None = None
     errors: Annotated[
         list[error.Error],
-        Field(description='Array of errors explaining why the operation failed', min_length=1),
+        Field(description="Array of errors explaining why the operation failed", min_length=1),
     ]
     ext: ext_1.ExtensionObject | None = None
 
 
 class CreateMediaBuyResponse1(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra="allow",
     )
     buyer_ref: Annotated[str, Field(description="Buyer's reference identifier for this media buy")]
     context: context_1.ContextObject | None = None
     creative_deadline: Annotated[
-        AwareDatetime | None, Field(description='ISO 8601 timestamp for creative upload deadline')
+        AwareDatetime | None, Field(description="ISO 8601 timestamp for creative upload deadline")
     ] = None
     ext: ext_1.ExtensionObject | None = None
     media_buy_id: Annotated[
@@ -42,7 +42,7 @@ class CreateMediaBuyResponse1(AdCPBaseModel):
     ]
     packages: Annotated[
         list[package.Package],
-        Field(description='Array of created packages with complete state information'),
+        Field(description="Array of created packages with complete state information"),
     ]
 
 
@@ -50,7 +50,7 @@ class CreateMediaBuyResponse(RootModel[CreateMediaBuyResponse1 | CreateMediaBuyR
     root: Annotated[
         CreateMediaBuyResponse1 | CreateMediaBuyResponse2,
         Field(
-            description='Response payload for create_media_buy task. Returns either complete success data OR error information, never both. This enforces atomic operation semantics - the media buy is either fully created or not created at all.',
-            title='Create Media Buy Response',
+            description="Response payload for create_media_buy task. Returns either complete success data OR error information, never both. This enforces atomic operation semantics - the media buy is either fully created or not created at all.",
+            title="Create Media Buy Response",
         ),
     ]

adcp/types/generated_poc/media_buy/get_media_buy_delivery_request.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  media_buy/get_media_buy_delivery_request.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -16,32 +16,32 @@ from ..enums import media_buy_status
 
 class GetMediaBuyDeliveryRequest(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra="allow",
     )
     buyer_refs: Annotated[
-        list[str] | None, Field(description='Array of buyer reference IDs to get delivery data for')
+        list[str] | None, Field(description="Array of buyer reference IDs to get delivery data for")
     ] = None
     context: context_1.ContextObject | None = None
     end_date: Annotated[
         str | None,
         Field(
-            description='End date for reporting period (YYYY-MM-DD)',
-            pattern='^\\d{4}-\\d{2}-\\d{2}$',
+            description="End date for reporting period (YYYY-MM-DD)",
+            pattern="^\\d{4}-\\d{2}-\\d{2}$",
         ),
     ] = None
     ext: ext_1.ExtensionObject | None = None
     media_buy_ids: Annotated[
         list[str] | None,
-        Field(description='Array of publisher media buy IDs to get delivery data for'),
+        Field(description="Array of publisher media buy IDs to get delivery data for"),
     ] = None
     start_date: Annotated[
         str | None,
         Field(
-            description='Start date for reporting period (YYYY-MM-DD)',
-            pattern='^\\d{4}-\\d{2}-\\d{2}$',
+            description="Start date for reporting period (YYYY-MM-DD)",
+            pattern="^\\d{4}-\\d{2}-\\d{2}$",
         ),
     ] = None
     status_filter: Annotated[
         media_buy_status.MediaBuyStatus | list[media_buy_status.MediaBuyStatus] | None,
-        Field(description='Filter by status. Can be a single status or array of statuses'),
+        Field(description="Filter by status. Can be a single status or array of statuses"),
     ] = None