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

adcp/types/generated_poc/enums/task_type.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/task_type.json
-#   timestamp: 2026-01-25T21:17:54+00:00
+#   timestamp: 2026-02-02T17:45:21+00:00
 
 from __future__ import annotations
 
@@ -8,14 +8,13 @@ from enum import Enum
 
 
 class TaskType(Enum):
-    create_media_buy = 'create_media_buy'
-    update_media_buy = 'update_media_buy'
-    sync_creatives = 'sync_creatives'
-    activate_signal = 'activate_signal'
-    get_signals = 'get_signals'
-    list_property_features = 'list_property_features'
-    create_property_list = 'create_property_list'
-    update_property_list = 'update_property_list'
-    get_property_list = 'get_property_list'
-    list_property_lists = 'list_property_lists'
-    delete_property_list = 'delete_property_list'
+    create_media_buy = "create_media_buy"
+    update_media_buy = "update_media_buy"
+    sync_creatives = "sync_creatives"
+    activate_signal = "activate_signal"
+    get_signals = "get_signals"
+    create_property_list = "create_property_list"
+    update_property_list = "update_property_list"
+    get_property_list = "get_property_list"
+    list_property_lists = "list_property_lists"
+    delete_property_list = "delete_property_list"

adcp/types/generated_poc/enums/update_frequency.py

@@ -8,7 +8,7 @@ from enum import Enum
 
 
 class UpdateFrequency(Enum):
-    realtime = 'realtime'
-    hourly = 'hourly'
-    daily = 'daily'
-    weekly = 'weekly'
+    realtime = "realtime"
+    hourly = "hourly"
+    daily = "daily"
+    weekly = "weekly"

adcp/types/generated_poc/enums/url_asset_type.py

@@ -8,6 +8,6 @@ from enum import Enum
 
 
 class UrlAssetType(Enum):
-    clickthrough = 'clickthrough'
-    tracker_pixel = 'tracker_pixel'
-    tracker_script = 'tracker_script'
+    clickthrough = "clickthrough"
+    tracker_pixel = "tracker_pixel"
+    tracker_script = "tracker_script"

adcp/types/generated_poc/enums/validation_mode.py

@@ -8,5 +8,5 @@ from enum import Enum
 
 
 class ValidationMode(Enum):
-    strict = 'strict'
-    lenient = 'lenient'
+    strict = "strict"
+    lenient = "lenient"

adcp/types/generated_poc/enums/vast_tracking_event.py

@@ -8,19 +8,19 @@ from enum import Enum
 
 
 class VastTrackingEvent(Enum):
-    start = 'start'
-    firstQuartile = 'firstQuartile'
-    midpoint = 'midpoint'
-    thirdQuartile = 'thirdQuartile'
-    complete = 'complete'
-    impression = 'impression'
-    click = 'click'
-    pause = 'pause'
-    resume = 'resume'
-    skip = 'skip'
-    mute = 'mute'
-    unmute = 'unmute'
-    fullscreen = 'fullscreen'
-    exitFullscreen = 'exitFullscreen'
-    playerExpand = 'playerExpand'
-    playerCollapse = 'playerCollapse'
+    start = "start"
+    firstQuartile = "firstQuartile"
+    midpoint = "midpoint"
+    thirdQuartile = "thirdQuartile"
+    complete = "complete"
+    impression = "impression"
+    click = "click"
+    pause = "pause"
+    resume = "resume"
+    skip = "skip"
+    mute = "mute"
+    unmute = "unmute"
+    fullscreen = "fullscreen"
+    exitFullscreen = "exitFullscreen"
+    playerExpand = "playerExpand"
+    playerCollapse = "playerCollapse"

adcp/types/generated_poc/enums/vast_version.py

@@ -8,8 +8,8 @@ from enum import Enum
 
 
 class VastVersion(Enum):
-    field_2_0 = '2.0'
-    field_3_0 = '3.0'
-    field_4_0 = '4.0'
-    field_4_1 = '4.1'
-    field_4_2 = '4.2'
+    field_2_0 = "2.0"
+    field_3_0 = "3.0"
+    field_4_0 = "4.0"
+    field_4_1 = "4.1"
+    field_4_2 = "4.2"

adcp/types/generated_poc/enums/webhook_response_type.py

@@ -8,7 +8,7 @@ from enum import Enum
 
 
 class WebhookResponseType(Enum):
-    html = 'html'
-    json = 'json'
-    xml = 'xml'
-    javascript = 'javascript'
+    html = "html"
+    json = "json"
+    xml = "xml"
+    javascript = "javascript"

adcp/types/generated_poc/enums/webhook_security_method.py

@@ -8,6 +8,6 @@ from enum import Enum
 
 
 class WebhookSecurityMethod(Enum):
-    hmac_sha256 = 'hmac_sha256'
-    api_key = 'api_key'
-    none = 'none'
+    hmac_sha256 = "hmac_sha256"
+    api_key = "api_key"
+    none = "none"

adcp/types/generated_poc/extensions/extension_meta.py

@@ -14,45 +14,45 @@ class AdcpExtensionFileSchema(AdCPBaseModel):
     field_id: Annotated[
         str,
         Field(
-            alias='$id',
-            description='Extension ID following pattern /schemas/extensions/{namespace}.json',
-            pattern='^/schemas/extensions/[a-z][a-z0-9_]*\\.json$',
+            alias="$id",
+            description="Extension ID following pattern /schemas/extensions/{namespace}.json",
+            pattern="^/schemas/extensions/[a-z][a-z0-9_]*\\.json$",
         ),
     ]
     field_schema: Annotated[
-        Literal['http://json-schema.org/draft-07/schema#'], Field(alias='$schema')
+        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'),
+        Field(description="Whether additional properties are allowed in the extension data"),
     ] = None
-    description: Annotated[str, Field(description='Description of what this extension provides')]
+    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')
+        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'),
+        Field(description="Schema properties defining the structure of ext.{namespace} data"),
     ]
     required: Annotated[
-        list[str] | None, Field(description='Required properties within the extension data')
+        list[str] | None, Field(description="Required properties within the extension data")
     ] = None
-    title: Annotated[str, Field(description='Human-readable title for the extension')]
+    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})'),
+        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+$',
+            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+$',
+            pattern="^\\d+\\.\\d+$",
         ),
     ] = None

adcp/types/generated_poc/media_buy/build_creative_request.py

@@ -17,25 +17,25 @@ from ..core import format_id
 
 class BuildCreativeRequest(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        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

@@ -17,13 +17,13 @@ from ..core import ext as ext_1
 
 class BuildCreativeResponse2(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        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='allow',
+        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

@@ -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='allow',
+        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

@@ -13,7 +13,7 @@ from ..core import ext as ext_1
 
 class CreateMediaBuySubmitted(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        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

@@ -15,17 +15,17 @@ from ..core import ext as ext_1
 
 class CreateMediaBuyWorking(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        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: 2026-01-25T21:17:54+00:00
+#   timestamp: 2026-02-02T17:45:21+00:00
 
 from __future__ import annotations
 
@@ -21,12 +21,12 @@ from . import package_request
 
 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,
         ),
     ]
@@ -41,22 +41,22 @@ class Authentication(AdCPBaseModel):
 
 
 class BatchFrequency(Enum):
-    hourly = 'hourly'
-    daily = 'daily'
+    hourly = "hourly"
+    daily = "daily"
 
 
 class DeliveryMode(Enum):
-    realtime = 'realtime'
-    batched = 'batched'
+    realtime = "realtime"
+    batched = "batched"
 
 
 class ArtifactWebhook(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
     authentication: Annotated[
         Authentication,
-        Field(description='Authentication configuration for webhook delivery (A2A-compatible)'),
+        Field(description="Authentication configuration for webhook delivery (A2A-compatible)"),
     ]
     batch_frequency: Annotated[
         BatchFrequency | None,
@@ -73,7 +73,7 @@ class ArtifactWebhook(AdCPBaseModel):
     sampling_rate: Annotated[
         float | None,
         Field(
-            description='Fraction of impressions to include (0-1). 1.0 = all impressions, 0.1 = 10% sample. Default: 1.0',
+            description="Fraction of impressions to include (0-1). 1.0 = all impressions, 0.1 = 10% sample. Default: 1.0",
             ge=0.0,
             le=1.0,
         ),
@@ -81,41 +81,47 @@ class ArtifactWebhook(AdCPBaseModel):
     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 artifact delivery')]
+    url: Annotated[AnyUrl, Field(description="Webhook endpoint URL for artifact delivery")]
 
 
 class TotalBudget(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra="forbid",
     )
-    amount: Annotated[float, Field(description='Total budget amount', ge=0.0)]
-    currency: Annotated[str, Field(description='ISO 4217 currency code')]
+    amount: Annotated[float, Field(description="Total budget amount", ge=0.0)]
+    currency: Annotated[str, Field(description="ISO 4217 currency code")]
 
 
 class CreateMediaBuyRequest(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        extra="allow",
     )
+    account_id: Annotated[
+        str | None,
+        Field(
+            description="Account to bill for this media buy. Optional if the agent has a single account or the seller can determine the account from context (brand + agent). Required if the agent has multiple accounts and the seller cannot route automatically."
+        ),
+    ] = None
     artifact_webhook: Annotated[
         ArtifactWebhook | None,
         Field(
-            description='Optional webhook configuration for content artifact delivery. Used by governance agents to validate content adjacency. Seller pushes artifacts to this endpoint; orchestrator forwards to governance agent for validation.'
+            description="Optional webhook configuration for content artifact delivery. Used by governance agents to validate content adjacency. Seller pushes artifacts to this endpoint; orchestrator forwards to governance agent for validation."
         ),
     ] = None
     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[
@@ -124,7 +130,7 @@ class CreateMediaBuyRequest(AdCPBaseModel):
             description="Array of package configurations. Required when not using proposal_id. When executing a proposal, this can be omitted and packages will be derived from the proposal's allocations."
         ),
     ] = None
-    po_number: Annotated[str | None, Field(description='Purchase order number for tracking')] = None
+    po_number: Annotated[str | None, Field(description="Purchase order number for tracking")] = None
     proposal_id: Annotated[
         str | None,
         Field(
@@ -133,7 +139,7 @@ class CreateMediaBuyRequest(AdCPBaseModel):
     ] = None
     reporting_webhook: Annotated[
         reporting_webhook_1.ReportingWebhook | None,
-        Field(description='Optional webhook configuration for automated reporting delivery'),
+        Field(description="Optional webhook configuration for automated reporting delivery"),
     ] = None
     start_time: start_timing.StartTiming
     total_budget: Annotated[

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: 2026-01-25T21:17:54+00:00
+#   timestamp: 2026-02-02T17:45:21+00:00
 
 from __future__ import annotations
 
@@ -9,6 +9,7 @@ from typing import Annotated
 from adcp.types.base import AdCPBaseModel
 from pydantic import AwareDatetime, ConfigDict, Field, RootModel
 
+from ..core import account as account_1
 from ..core import context as context_1
 from ..core import error
 from ..core import ext as ext_1
@@ -17,24 +18,30 @@ from ..core import package
 
 class CreateMediaBuyResponse2(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        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='allow',
+        extra="allow",
     )
+    account: Annotated[
+        account_1.Account | None,
+        Field(
+            description="Account billed for this media buy. Includes advertiser, billing proxy (if any), and rate card applied."
+        ),
+    ] = None
     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 +49,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 +57,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

@@ -16,32 +16,32 @@ from ..enums import media_buy_status
 
 class GetMediaBuyDeliveryRequest(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='allow',
+        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