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

adcp/types/generated_poc/format.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  format.json
-#   timestamp: 2025-11-15T22:03:55+00:00
+#   timestamp: 2025-11-18T03:04:10+00:00
 
 from __future__ import annotations
 
@@ -14,26 +14,26 @@ from . import format_id as format_id_1
 
 
 class AssetType(Enum):
-    image = "image"
-    video = "video"
-    audio = "audio"
-    vast = "vast"
-    daast = "daast"
-    text = "text"
-    markdown = "markdown"
-    html = "html"
-    css = "css"
-    javascript = "javascript"
-    url = "url"
-    webhook = "webhook"
-    promoted_offerings = "promoted_offerings"
+    image = 'image'
+    video = 'video'
+    audio = 'audio'
+    vast = 'vast'
+    daast = 'daast'
+    text = 'text'
+    markdown = 'markdown'
+    html = 'html'
+    css = 'css'
+    javascript = 'javascript'
+    url = 'url'
+    webhook = 'webhook'
+    promoted_offerings = 'promoted_offerings'
 
 
 class AssetsRequired(AdCPBaseModel):
     asset_id: Annotated[
         str,
         Field(
-            description="Unique identifier for this asset. Creative manifests MUST use this exact value as the key in the assets object."
+            description='Unique identifier for this asset. Creative manifests MUST use this exact value as the key in the assets object.'
         ),
     ]
     asset_role: Annotated[
@@ -42,34 +42,34 @@ class AssetsRequired(AdCPBaseModel):
             description="Optional descriptive label for this asset's purpose (e.g., 'hero_image', 'logo'). Not used for referencing assets in manifests—use asset_id instead. This field is for human-readable documentation and UI display only."
         ),
     ] = None
-    asset_type: Annotated[AssetType, Field(description="Type of asset")]
+    asset_type: Annotated[AssetType, Field(description='Type of asset')]
     item_type: Annotated[
-        Literal["individual"],
-        Field(description="Discriminator indicating this is an individual asset requirement"),
+        Literal['individual'],
+        Field(description='Discriminator indicating this is an individual asset requirement'),
     ]
-    required: Annotated[bool | None, Field(description="Whether this asset is required")] = None
+    required: Annotated[bool | None, Field(description='Whether this asset is required')] = None
     requirements: Annotated[
         dict[str, Any] | None,
         Field(
-            description="Technical requirements for this asset (dimensions, file size, duration, etc.)"
+            description='Technical requirements for this asset (dimensions, file size, duration, etc.)'
         ),
     ] = None
 
 
 class Asset(AdCPBaseModel):
-    asset_id: Annotated[str, Field(description="Identifier for this asset within the group")]
+    asset_id: Annotated[str, Field(description='Identifier for this asset within the group')]
     asset_role: Annotated[
         str | None,
         Field(
             description="Optional descriptive label for this asset's purpose (e.g., 'hero_image', 'logo'). Not used for referencing assets in manifests—use asset_id instead. This field is for human-readable documentation and UI display only."
         ),
     ] = None
-    asset_type: Annotated[AssetType, Field(description="Type of asset")]
+    asset_type: Annotated[AssetType, Field(description='Type of asset')]
     required: Annotated[
-        bool | None, Field(description="Whether this asset is required in each repetition")
+        bool | None, Field(description='Whether this asset is required in each repetition')
     ] = None
     requirements: Annotated[
-        dict[str, Any] | None, Field(description="Technical requirements for this asset")
+        dict[str, Any] | None, Field(description='Technical requirements for this asset')
     ] = None
 
 
@@ -77,45 +77,45 @@ class AssetsRequired1(AdCPBaseModel):
     asset_group_id: Annotated[
         str, Field(description="Identifier for this asset group (e.g., 'product', 'slide', 'card')")
     ]
-    assets: Annotated[list[Asset], Field(description="Assets within each repetition of this group")]
+    assets: Annotated[list[Asset], Field(description='Assets within each repetition of this group')]
     item_type: Annotated[
-        Literal["repeatable_group"],
-        Field(description="Discriminator indicating this is a repeatable asset group"),
+        Literal['repeatable_group'],
+        Field(description='Discriminator indicating this is a repeatable asset group'),
     ]
-    max_count: Annotated[int, Field(description="Maximum number of repetitions allowed", ge=1)]
-    min_count: Annotated[int, Field(description="Minimum number of repetitions required", ge=1)]
+    max_count: Annotated[int, Field(description='Maximum number of repetitions allowed', ge=1)]
+    min_count: Annotated[int, Field(description='Minimum number of repetitions required', ge=1)]
 
 
 class FormatCard(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="forbid",
+        extra='forbid',
     )
     format_id: Annotated[
         format_id_1.FormatId,
         Field(
-            description="Creative format defining the card layout (typically format_card_standard)"
+            description='Creative format defining the card layout (typically format_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 FormatCardDetailed(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 format_card_detailed)"
+            description='Creative format defining the detailed card layout (typically format_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'
         ),
     ]
 
@@ -126,10 +126,10 @@ class Responsive(AdCPBaseModel):
 
 
 class Unit(Enum):
-    px = "px"
-    dp = "dp"
-    inches = "inches"
-    cm = "cm"
+    px = 'px'
+    dp = 'dp'
+    inches = 'inches'
+    cm = 'cm'
 
 
 class Dimensions(AdCPBaseModel):
@@ -137,35 +137,35 @@ class Dimensions(AdCPBaseModel):
         str | None,
         Field(
             description="Fixed aspect ratio constraint (e.g., '16:9', '4:3', '1:1')",
-            pattern="^\\d+:\\d+$",
+            pattern='^\\d+:\\d+$',
         ),
     ] = None
     height: Annotated[
-        float | None, Field(description="Fixed height in specified units", ge=0.0)
+        float | None, Field(description='Fixed height in specified units', ge=0.0)
     ] = None
     max_height: Annotated[
-        float | None, Field(description="Maximum height for responsive renders", ge=0.0)
+        float | None, Field(description='Maximum height for responsive renders', ge=0.0)
     ] = None
     max_width: Annotated[
-        float | None, Field(description="Maximum width for responsive renders", ge=0.0)
+        float | None, Field(description='Maximum width for responsive renders', ge=0.0)
     ] = None
     min_height: Annotated[
-        float | None, Field(description="Minimum height for responsive renders", ge=0.0)
+        float | None, Field(description='Minimum height for responsive renders', ge=0.0)
     ] = None
     min_width: Annotated[
-        float | None, Field(description="Minimum width for responsive renders", ge=0.0)
+        float | None, Field(description='Minimum width for responsive renders', ge=0.0)
     ] = None
     responsive: Annotated[
-        Responsive | None, Field(description="Indicates which dimensions are responsive/fluid")
+        Responsive | None, Field(description='Indicates which dimensions are responsive/fluid')
     ] = None
-    unit: Annotated[Unit, Field(description="Unit of measurement for dimensions")]
-    width: Annotated[float | None, Field(description="Fixed width in specified units", ge=0.0)] = (
+    unit: Annotated[Unit, Field(description='Unit of measurement for dimensions')]
+    width: Annotated[float | None, Field(description='Fixed width in specified units', ge=0.0)] = (
         None
     )
 
 
 class Render(AdCPBaseModel):
-    dimensions: Annotated[Dimensions, Field(description="Dimensions for this rendered piece")]
+    dimensions: Annotated[Dimensions, Field(description='Dimensions for this rendered piece')]
     role: Annotated[
         str,
         Field(
@@ -175,86 +175,86 @@ class Render(AdCPBaseModel):
 
 
 class Type(Enum):
-    audio = "audio"
-    video = "video"
-    display = "display"
-    native = "native"
-    dooh = "dooh"
-    rich_media = "rich_media"
-    universal = "universal"
+    audio = 'audio'
+    video = 'video'
+    display = 'display'
+    native = 'native'
+    dooh = 'dooh'
+    rich_media = 'rich_media'
+    universal = 'universal'
 
 
 class Format(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="forbid",
+        extra='forbid',
     )
     assets_required: Annotated[
         list[AssetsRequired | AssetsRequired1] | None,
         Field(
-            description="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)."
+            description='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).'
         ),
     ] = None
     delivery: Annotated[
         dict[str, Any] | None,
-        Field(description="Delivery method specifications (e.g., hosted, VAST, third-party tags)"),
+        Field(description='Delivery method specifications (e.g., hosted, VAST, third-party tags)'),
     ] = None
     description: Annotated[
         str | None,
         Field(
-            description="Plain text explanation of what this format does and what assets it requires"
+            description='Plain text explanation of what this format does and what assets it requires'
         ),
     ] = None
     example_url: Annotated[
         AnyUrl | None,
         Field(
-            description="Optional URL to showcase page with examples and interactive demos of this format"
+            description='Optional URL to showcase page with examples and interactive demos of this format'
         ),
     ] = None
     format_card: Annotated[
         FormatCard | None,
         Field(
-            description="Optional standard visual card (300x400px) for displaying this format in user interfaces. Can be rendered via preview_creative or pre-generated."
+            description='Optional standard visual card (300x400px) for displaying this format in user interfaces. Can be rendered via preview_creative or pre-generated.'
         ),
     ] = None
     format_card_detailed: Annotated[
         FormatCardDetailed | None,
         Field(
-            description="Optional detailed card with carousel and full specifications. Provides rich format documentation similar to ad spec pages."
+            description='Optional detailed card with carousel and full specifications. Provides rich format documentation similar to ad spec pages.'
         ),
     ] = None
     format_id: Annotated[
         format_id_1.FormatId,
-        Field(description="Structured format identifier with agent URL and format name"),
+        Field(description='Structured format identifier with agent URL and format name'),
     ]
-    name: Annotated[str, Field(description="Human-readable format name")]
+    name: Annotated[str, Field(description='Human-readable format name')]
     output_format_ids: Annotated[
         list[format_id_1.FormatId] | None,
         Field(
-            description="For generative formats: array of format IDs that this format can generate. When a format accepts inputs like brand_manifest and message, this specifies what concrete output formats can be produced (e.g., a generative banner format might output standard image banner formats)."
+            description='For generative formats: array of format IDs that this format can generate. When a format accepts inputs like brand_manifest and message, this specifies what concrete output formats can be produced (e.g., a generative banner format might output standard image banner formats).'
         ),
     ] = None
     preview_image: Annotated[
         AnyUrl | None,
         Field(
-            description="DEPRECATED: Use format_card instead. Optional preview image URL for format browsing/discovery UI. Should be 400x300px (4:3 aspect ratio) PNG or JPG. Used as thumbnail/card image in format browsers. This field is maintained for backward compatibility but format_card provides a more flexible, structured approach."
+            description='DEPRECATED: Use format_card instead. Optional preview image URL for format browsing/discovery UI. Should be 400x300px (4:3 aspect ratio) PNG or JPG. Used as thumbnail/card image in format browsers. This field is maintained for backward compatibility but format_card provides a more flexible, structured approach.'
         ),
     ] = None
     renders: Annotated[
         list[Render] | None,
         Field(
-            description="Specification of rendered pieces for this format. Most formats produce a single render. Companion ad formats (video + banner), adaptive formats, and multi-placement formats produce multiple renders. Each render specifies its role and dimensions.",
+            description='Specification of rendered pieces for this format. Most formats produce a single render. Companion ad formats (video + banner), adaptive formats, and multi-placement formats produce multiple renders. Each render specifies its role and dimensions.',
             min_length=1,
         ),
     ] = None
     supported_macros: Annotated[
         list[str] | None,
         Field(
-            description="List of universal macros supported by this format (e.g., MEDIA_BUY_ID, CACHEBUSTER, DEVICE_ID). Used for validation and developer tooling."
+            description='List of universal macros supported by this format (e.g., MEDIA_BUY_ID, CACHEBUSTER, DEVICE_ID). Used for validation and developer tooling.'
         ),
     ] = None
     type: Annotated[
         Type,
         Field(
-            description="Media type of this format - determines rendering method and asset requirements"
+            description='Media type of this format - determines rendering method and asset requirements'
         ),
     ]

adcp/types/generated_poc/format_id.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  format-id.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 AnyUrl, ConfigDict, Field
 
 class FormatId(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="forbid",
+        extra='forbid',
     )
     agent_url: Annotated[
         AnyUrl,
@@ -24,6 +24,6 @@ class FormatId(AdCPBaseModel):
         str,
         Field(
             description="Format identifier within the agent's namespace (e.g., 'display_300x250', 'video_standard_30s')",
-            pattern="^[a-zA-Z0-9_-]+$",
+            pattern='^[a-zA-Z0-9_-]+$',
         ),
     ]

adcp/types/generated_poc/frequency_cap.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  frequency-cap.json
-#   timestamp: 2025-11-15T22:03:55+00:00
+#   timestamp: 2025-11-18T03:04:10+00:00
 
 from __future__ import annotations
 
@@ -12,8 +12,8 @@ from pydantic import ConfigDict, Field
 
 class FrequencyCap(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="forbid",
+        extra='forbid',
     )
     suppress_minutes: Annotated[
-        float, Field(description="Minutes to suppress after impression", ge=0.0)
+        float, Field(description='Minutes to suppress after impression', ge=0.0)
     ]

adcp/types/generated_poc/frequency_cap_scope.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  frequency-cap-scope.json
-#   timestamp: 2025-11-15T22:03:55+00:00
+#   timestamp: 2025-11-18T03:04:10+00:00
 
 from __future__ import annotations
 
@@ -9,8 +9,8 @@ from typing import Annotated, Literal
 from pydantic import Field, RootModel
 
 
-class FrequencyCapScope(RootModel[Literal["package"]]):
+class FrequencyCapScope(RootModel[Literal['package']]):
     root: Annotated[
-        Literal["package"],
-        Field(description="Scope for frequency cap application", title="Frequency Cap Scope"),
+        Literal['package'],
+        Field(description='Scope for frequency cap application', title='Frequency Cap Scope'),
     ]

adcp/types/generated_poc/get_media_buy_delivery_request.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  get-media-buy-delivery-request.json
-#   timestamp: 2025-11-15T22:03:55+00:00
+#   timestamp: 2025-11-18T03:04:10+00:00
 
 from __future__ import annotations
 
@@ -12,54 +12,54 @@ from pydantic import ConfigDict, Field
 
 
 class StatusFilter(Enum):
-    active = "active"
-    pending = "pending"
-    paused = "paused"
-    completed = "completed"
-    failed = "failed"
-    all = "all"
+    active = 'active'
+    pending = 'pending'
+    paused = 'paused'
+    completed = 'completed'
+    failed = 'failed'
+    all = 'all'
 
 
 class StatusFilterEnum(Enum):
-    active = "active"
-    pending = "pending"
-    paused = "paused"
-    completed = "completed"
-    failed = "failed"
+    active = 'active'
+    pending = 'pending'
+    paused = 'paused'
+    completed = 'completed'
+    failed = 'failed'
 
 
 class GetMediaBuyDeliveryRequest(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="forbid",
+        extra='forbid',
     )
     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: 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
     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
     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[
         StatusFilter | list[StatusFilterEnum] | 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