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

adcp/types/generated_poc/creative/preview_creative_request.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  creative/preview_creative_request.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -18,7 +18,7 @@ from ..enums import preview_output_format
 
 class Input(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra="allow",
     )
     context_description: Annotated[
         str | None,
@@ -29,7 +29,7 @@ class Input(AdCPBaseModel):
     macros: Annotated[
         dict[str, str] | None,
         Field(
-            description="Macro values to use for this preview. Supports all universal macros from the format's supported_macros list. See docs/media-buy/creatives/universal-macros.md for available macros."
+            description="Macro values to use for this preview. Supports all universal macros from the format's supported_macros list. See docs/creative/universal-macros.md for available macros."
         ),
     ] = None
     name: Annotated[
@@ -42,37 +42,37 @@ class Input(AdCPBaseModel):
 
 class Input2(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra="allow",
     )
     context_description: Annotated[
         str | None,
-        Field(description='Natural language description of the context for AI-generated content'),
+        Field(description="Natural language description of the context for AI-generated content"),
     ] = None
     macros: Annotated[
-        dict[str, str] | None, Field(description='Macro values to use for this preview')
+        dict[str, str] | None, Field(description="Macro values to use for this preview")
     ] = None
-    name: Annotated[str, Field(description='Human-readable name for this input set')]
+    name: Annotated[str, Field(description="Human-readable name for this input set")]
 
 
 class PreviewCreativeRequest1(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra="allow",
     )
     context: context_1.ContextObject | None = None
     creative_manifest: Annotated[
         creative_manifest_1.CreativeManifest,
         Field(
-            description='Complete creative manifest with all required assets (including promoted_offerings if required by the format)'
+            description="Complete creative manifest with all required assets (including promoted_offerings if required by the format)"
         ),
     ]
     ext: ext_1.ExtensionObject | None = None
     format_id: Annotated[
-        format_id_1.FormatId, Field(description='Format identifier for rendering the preview')
+        format_id_1.FormatId, Field(description="Format identifier for rendering the preview")
     ]
     inputs: Annotated[
         list[Input] | None,
         Field(
-            description='Array of input sets for generating multiple preview variants. Each input set defines macros and context values for one preview rendering. If not provided, creative agent will generate default previews.'
+            description="Array of input sets for generating multiple preview variants. Each input set defines macros and context values for one preview rendering. If not provided, creative agent will generate default previews."
         ),
     ] = None
     output_format: Annotated[
@@ -82,28 +82,28 @@ class PreviewCreativeRequest1(AdCPBaseModel):
         ),
     ] = preview_output_format.PreviewOutputFormat.url
     request_type: Annotated[
-        Literal['single'],
-        Field(description='Discriminator indicating this is a single preview request'),
+        Literal["single"],
+        Field(description="Discriminator indicating this is a single preview request"),
     ]
     template_id: Annotated[
-        str | None, Field(description='Specific template ID for custom format rendering')
+        str | None, Field(description="Specific template ID for custom format rendering")
     ] = None
 
 
 class Request(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra="allow",
     )
     creative_manifest: Annotated[
         creative_manifest_1.CreativeManifest,
-        Field(description='Complete creative manifest with all required assets'),
+        Field(description="Complete creative manifest with all required assets"),
     ]
     format_id: Annotated[
-        format_id_1.FormatId, Field(description='Format identifier for rendering the preview')
+        format_id_1.FormatId, Field(description="Format identifier for rendering the preview")
     ]
     inputs: Annotated[
         list[Input2] | None,
-        Field(description='Array of input sets for generating multiple preview variants'),
+        Field(description="Array of input sets for generating multiple preview variants"),
     ] = None
     output_format: Annotated[
         preview_output_format.PreviewOutputFormat | None,
@@ -112,13 +112,13 @@ class Request(AdCPBaseModel):
         ),
     ] = preview_output_format.PreviewOutputFormat.url
     template_id: Annotated[
-        str | None, Field(description='Specific template ID for custom format rendering')
+        str | None, Field(description="Specific template ID for custom format rendering")
     ] = None
 
 
 class PreviewCreativeRequest2(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra="allow",
     )
     context: context_1.ContextObject | None = None
     ext: ext_1.ExtensionObject | None = None
@@ -129,13 +129,13 @@ class PreviewCreativeRequest2(AdCPBaseModel):
         ),
     ] = preview_output_format.PreviewOutputFormat.url
     request_type: Annotated[
-        Literal['batch'],
-        Field(description='Discriminator indicating this is a batch preview request'),
+        Literal["batch"],
+        Field(description="Discriminator indicating this is a batch preview request"),
     ]
     requests: Annotated[
         list[Request],
         Field(
-            description='Array of preview requests (1-50 items). Each follows the single request structure.',
+            description="Array of preview requests (1-50 items). Each follows the single request structure.",
             max_length=50,
             min_length=1,
         ),
@@ -146,8 +146,8 @@ class PreviewCreativeRequest(RootModel[PreviewCreativeRequest1 | PreviewCreative
     root: Annotated[
         PreviewCreativeRequest1 | PreviewCreativeRequest2,
         Field(
-            discriminator='request_type',
-            description='Request to generate previews of one or more creative manifests. Accepts either a single creative request or an array of requests for batch processing.',
-            title='Preview Creative Request',
+            discriminator="request_type",
+            description="Request to generate previews of one or more creative manifests. Accepts either a single creative request or an array of requests for batch processing.",
+            title="Preview Creative Request",
         ),
     ]

adcp/types/generated_poc/creative/preview_creative_response.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  creative/preview_creative_response.json
-#   timestamp: 2025-12-11T15:09:37+00:00
+#   timestamp: 2026-01-14T17:08:13+00:00
 
 from __future__ import annotations
 
@@ -16,12 +16,12 @@ from . import preview_render
 
 class Input(AdCPBaseModel):
     context_description: Annotated[
-        str | None, Field(description='Context description applied to this variant')
+        str | None, Field(description="Context description applied to this variant")
     ] = None
     macros: Annotated[
-        dict[str, str] | None, Field(description='Macro values applied to this variant')
+        dict[str, str] | None, Field(description="Macro values applied to this variant")
     ] = None
-    name: Annotated[str, Field(description='Human-readable name for this variant')]
+    name: Annotated[str, Field(description="Human-readable name for this variant")]
 
 
 class Error(AdCPBaseModel):
@@ -31,8 +31,8 @@ class Error(AdCPBaseModel):
             description="Error code (e.g., 'invalid_manifest', 'unsupported_format', 'missing_assets')"
         ),
     ]
-    details: Annotated[dict[str, Any] | None, Field(description='Additional error context')] = None
-    message: Annotated[str, Field(description='Human-readable error message')]
+    details: Annotated[dict[str, Any] | None, Field(description="Additional error context")] = None
+    message: Annotated[str, Field(description="Human-readable error message")]
 
 
 class Input4(AdCPBaseModel):
@@ -45,14 +45,14 @@ class Preview(AdCPBaseModel):
     input: Annotated[
         Input,
         Field(
-            description='The input parameters that generated this preview variant. Echoes back the request input or shows defaults used.'
+            description="The input parameters that generated this preview variant. Echoes back the request input or shows defaults used."
         ),
     ]
-    preview_id: Annotated[str, Field(description='Unique identifier for this preview variant')]
+    preview_id: Annotated[str, Field(description="Unique identifier for this preview variant")]
     renders: Annotated[
         list[preview_render.PreviewRender],
         Field(
-            description='Array of rendered pieces for this preview variant. Most formats render as a single piece. Companion ad formats (video + banner), multi-placement formats, and adaptive formats render as multiple pieces.',
+            description="Array of rendered pieces for this preview variant. Most formats render as a single piece. Companion ad formats (video + banner), multi-placement formats, and adaptive formats render as multiple pieces.",
             min_length=1,
         ),
     ]
@@ -60,29 +60,29 @@ class Preview(AdCPBaseModel):
 
 class PreviewCreativeResponse1(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra="allow",
     )
     context: context_1.ContextObject | None = None
     expires_at: Annotated[
-        AwareDatetime, Field(description='ISO 8601 timestamp when preview links expire')
+        AwareDatetime, Field(description="ISO 8601 timestamp when preview links expire")
     ]
     ext: ext_1.ExtensionObject | None = None
     interactive_url: Annotated[
         AnyUrl | None,
         Field(
-            description='Optional URL to an interactive testing page that shows all preview variants with controls to switch between them, modify macro values, and test different scenarios.'
+            description="Optional URL to an interactive testing page that shows all preview variants with controls to switch between them, modify macro values, and test different scenarios."
         ),
     ] = None
     previews: Annotated[
         list[Preview],
         Field(
-            description='Array of preview variants. Each preview corresponds to an input set from the request. If no inputs were provided, returns a single default preview.',
+            description="Array of preview variants. Each preview corresponds to an input set from the request. If no inputs were provided, returns a single default preview.",
             min_length=1,
         ),
     ]
     response_type: Annotated[
-        Literal['single'],
-        Field(description='Discriminator indicating this is a single preview response'),
+        Literal["single"],
+        Field(description="Discriminator indicating this is a single preview response"),
     ]
 
 
@@ -97,19 +97,20 @@ class Response(AdCPBaseModel):
     interactive_url: AnyUrl | None = None
     previews: Annotated[
         list[Preview1],
-        Field(description='Array of preview variants for this creative', min_length=1),
+        Field(description="Array of preview variants for this creative", min_length=1),
     ]
 
 
 class Results(AdCPBaseModel):
-    error: Annotated[Error | None, Field(description='Error information for failed requests')] = (
+    error: Annotated[Error | None, Field(description="Error information for failed requests")] = (
         None
     )
-    response: Annotated[Response, Field(description='Preview response for successful requests')]
-    success: Annotated[Literal[True], Field(description='Whether this preview request succeeded')]
+    response: Annotated[Response, Field(description="Preview response for successful requests")]
+    success: Annotated[Literal[True], Field(description="Whether this preview request succeeded")]
 
 
-Preview2 = Preview1
+class Preview2(Preview1):
+    pass
 
 
 class Response1(AdCPBaseModel):
@@ -117,32 +118,32 @@ class Response1(AdCPBaseModel):
     interactive_url: AnyUrl | None = None
     previews: Annotated[
         list[Preview2],
-        Field(description='Array of preview variants for this creative', min_length=1),
+        Field(description="Array of preview variants for this creative", min_length=1),
     ]
 
 
 class Results1(AdCPBaseModel):
-    error: Annotated[Error, Field(description='Error information for failed requests')]
+    error: Annotated[Error, Field(description="Error information for failed requests")]
     response: Annotated[
-        Response1 | None, Field(description='Preview response for successful requests')
+        Response1 | None, Field(description="Preview response for successful requests")
     ] = None
-    success: Annotated[Literal[False], Field(description='Whether this preview request succeeded')]
+    success: Annotated[Literal[False], Field(description="Whether this preview request succeeded")]
 
 
 class PreviewCreativeResponse2(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra="allow",
     )
     context: context_1.ContextObject | None = None
     ext: ext_1.ExtensionObject | None = None
     response_type: Annotated[
-        Literal['batch'],
-        Field(description='Discriminator indicating this is a batch preview response'),
+        Literal["batch"],
+        Field(description="Discriminator indicating this is a batch preview response"),
     ]
     results: Annotated[
         list[Results | Results1],
         Field(
-            description='Array of preview results corresponding to each request in the same order. results[0] is the result for requests[0], results[1] for requests[1], etc. Order is guaranteed even when some requests fail. Each result contains either a successful preview response or an error.',
+            description="Array of preview results corresponding to each request in the same order. results[0] is the result for requests[0], results[1] for requests[1], etc. Order is guaranteed even when some requests fail. Each result contains either a successful preview response or an error.",
             min_length=1,
         ),
     ]
@@ -152,7 +153,7 @@ class PreviewCreativeResponse(RootModel[PreviewCreativeResponse1 | PreviewCreati
     root: Annotated[
         PreviewCreativeResponse1 | PreviewCreativeResponse2,
         Field(
-            description='Response containing preview links for one or more creatives. Format matches the request: single preview response for single requests, batch results for batch requests.',
-            title='Preview Creative Response',
+            description="Response containing preview links for one or more creatives. Format matches the request: single preview response for single requests, batch results for batch requests.",
+            title="Preview Creative Response",
         ),
     ]

adcp/types/generated_poc/creative/preview_render.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  creative/preview_render.json
-#   timestamp: 2025-12-11T15:09:37+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -17,7 +17,7 @@ class Dimensions(AdCPBaseModel):
 
 class Embedding(AdCPBaseModel):
     csp_policy: Annotated[
-        str | None, Field(description='Content Security Policy requirements for embedding')
+        str | None, Field(description="Content Security Policy requirements for embedding")
     ] = None
     recommended_sandbox: Annotated[
         str | None,
@@ -26,35 +26,35 @@ class Embedding(AdCPBaseModel):
         ),
     ] = None
     requires_https: Annotated[
-        bool | None, Field(description='Whether this output requires HTTPS for secure embedding')
+        bool | None, Field(description="Whether this output requires HTTPS for secure embedding")
     ] = None
     supports_fullscreen: Annotated[
-        bool | None, Field(description='Whether this output supports fullscreen mode')
+        bool | None, Field(description="Whether this output supports fullscreen mode")
     ] = None
 
 
 class PreviewRender1(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra="allow",
     )
     dimensions: Annotated[
-        Dimensions | None, Field(description='Dimensions for this rendered piece')
+        Dimensions | None, Field(description="Dimensions for this rendered piece")
     ] = None
     embedding: Annotated[
         Embedding | None,
-        Field(description='Optional security and embedding metadata for safe iframe integration'),
+        Field(description="Optional security and embedding metadata for safe iframe integration"),
     ] = None
     output_format: Annotated[
-        Literal['url'], Field(description='Discriminator indicating preview_url is provided')
+        Literal["url"], Field(description="Discriminator indicating preview_url is provided")
     ]
     preview_url: Annotated[
         AnyUrl,
         Field(
-            description='URL to an HTML page that renders this piece. Can be embedded in an iframe.'
+            description="URL to an HTML page that renders this piece. Can be embedded in an iframe."
         ),
     ]
     render_id: Annotated[
-        str, Field(description='Unique identifier for this rendered piece within the variant')
+        str, Field(description="Unique identifier for this rendered piece within the variant")
     ]
     role: Annotated[
         str,
@@ -66,25 +66,25 @@ class PreviewRender1(AdCPBaseModel):
 
 class PreviewRender2(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra="allow",
     )
     dimensions: Annotated[
-        Dimensions | None, Field(description='Dimensions for this rendered piece')
+        Dimensions | None, Field(description="Dimensions for this rendered piece")
     ] = None
     embedding: Annotated[
-        Embedding | None, Field(description='Optional security and embedding metadata')
+        Embedding | None, Field(description="Optional security and embedding metadata")
     ] = None
     output_format: Annotated[
-        Literal['html'], Field(description='Discriminator indicating preview_html is provided')
+        Literal["html"], Field(description="Discriminator indicating preview_html is provided")
     ]
     preview_html: Annotated[
         str,
         Field(
-            description='Raw HTML for this rendered piece. Can be embedded directly in the page without iframe. Security warning: Only use with trusted creative agents as this bypasses iframe sandboxing.'
+            description="Raw HTML for this rendered piece. Can be embedded directly in the page without iframe. Security warning: Only use with trusted creative agents as this bypasses iframe sandboxing."
         ),
     ]
     render_id: Annotated[
-        str, Field(description='Unique identifier for this rendered piece within the variant')
+        str, Field(description="Unique identifier for this rendered piece within the variant")
     ]
     role: Annotated[
         str,
@@ -96,35 +96,35 @@ class PreviewRender2(AdCPBaseModel):
 
 class PreviewRender3(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra="allow",
     )
     dimensions: Annotated[
-        Dimensions | None, Field(description='Dimensions for this rendered piece')
+        Dimensions | None, Field(description="Dimensions for this rendered piece")
     ] = None
     embedding: Annotated[
         Embedding | None,
-        Field(description='Optional security and embedding metadata for safe iframe integration'),
+        Field(description="Optional security and embedding metadata for safe iframe integration"),
     ] = None
     output_format: Annotated[
-        Literal['both'],
+        Literal["both"],
         Field(
-            description='Discriminator indicating both preview_url and preview_html are provided'
+            description="Discriminator indicating both preview_url and preview_html are provided"
         ),
     ]
     preview_html: Annotated[
         str,
         Field(
-            description='Raw HTML for this rendered piece. Can be embedded directly in the page without iframe. Security warning: Only use with trusted creative agents as this bypasses iframe sandboxing.'
+            description="Raw HTML for this rendered piece. Can be embedded directly in the page without iframe. Security warning: Only use with trusted creative agents as this bypasses iframe sandboxing."
         ),
     ]
     preview_url: Annotated[
         AnyUrl,
         Field(
-            description='URL to an HTML page that renders this piece. Can be embedded in an iframe.'
+            description="URL to an HTML page that renders this piece. Can be embedded in an iframe."
         ),
     ]
     render_id: Annotated[
-        str, Field(description='Unique identifier for this rendered piece within the variant')
+        str, Field(description="Unique identifier for this rendered piece within the variant")
     ]
     role: Annotated[
         str,
@@ -138,7 +138,7 @@ class PreviewRender(RootModel[PreviewRender1 | PreviewRender2 | PreviewRender3])
     root: Annotated[
         PreviewRender1 | PreviewRender2 | PreviewRender3,
         Field(
-            description='A single rendered piece of a creative preview with discriminated output format',
-            title='Preview Render',
+            description="A single rendered piece of a creative preview with discriminated output format",
+            title="Preview Render",
         ),
     ]

adcp/types/generated_poc/enums/adcp_domain.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  enums/adcp_domain.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-14T17:08:13+00:00
 
 from __future__ import annotations
 
@@ -8,5 +8,7 @@ from enum import Enum
 
 
 class AdcpDomain(Enum):
-    media_buy = 'media-buy'
-    signals = 'signals'
+    media_buy = "media-buy"
+    signals = "signals"
+    governance = "governance"
+    creative = "creative"

adcp/types/generated_poc/enums/asset_content_type.py

@@ -8,16 +8,16 @@ from enum import Enum
 
 
 class AssetContentType(Enum):
-    image = 'image'
-    video = 'video'
-    audio = 'audio'
-    text = 'text'
-    markdown = 'markdown'
-    html = 'html'
-    css = 'css'
-    javascript = 'javascript'
-    vast = 'vast'
-    daast = 'daast'
-    promoted_offerings = 'promoted_offerings'
-    url = 'url'
-    webhook = 'webhook'
+    image = "image"
+    video = "video"
+    audio = "audio"
+    text = "text"
+    markdown = "markdown"
+    html = "html"
+    css = "css"
+    javascript = "javascript"
+    vast = "vast"
+    daast = "daast"
+    promoted_offerings = "promoted_offerings"
+    url = "url"
+    webhook = "webhook"

adcp/types/generated_poc/enums/auth_scheme.py

@@ -8,5 +8,5 @@ from enum import Enum
 
 
 class AuthenticationScheme(Enum):
-    Bearer = 'Bearer'
-    HMAC_SHA256 = 'HMAC-SHA256'
+    Bearer = "Bearer"
+    HMAC_SHA256 = "HMAC-SHA256"

adcp/types/generated_poc/enums/available_metric.py

@@ -8,12 +8,12 @@ from enum import Enum
 
 
 class AvailableMetric(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"

adcp/types/generated_poc/enums/channels.py

@@ -8,12 +8,12 @@ from enum import Enum
 
 
 class AdvertisingChannels(Enum):
-    display = 'display'
-    video = 'video'
-    audio = 'audio'
-    native = 'native'
-    dooh = 'dooh'
-    ctv = 'ctv'
-    podcast = 'podcast'
-    retail = 'retail'
-    social = 'social'
+    display = "display"
+    video = "video"
+    audio = "audio"
+    native = "native"
+    dooh = "dooh"
+    ctv = "ctv"
+    podcast = "podcast"
+    retail = "retail"
+    social = "social"

adcp/types/generated_poc/enums/co_branding_requirement.py

@@ -8,6 +8,6 @@ from enum import Enum
 
 
 class CoBrandingRequirement(Enum):
-    required = 'required'
-    optional = 'optional'
-    none = 'none'
+    required = "required"
+    optional = "optional"
+    none = "none"

adcp/types/generated_poc/enums/creative_action.py

@@ -8,8 +8,8 @@ from enum import Enum
 
 
 class CreativeAction(Enum):
-    created = 'created'
-    updated = 'updated'
-    unchanged = 'unchanged'
-    failed = 'failed'
-    deleted = 'deleted'
+    created = "created"
+    updated = "updated"
+    unchanged = "unchanged"
+    failed = "failed"
+    deleted = "deleted"

adcp/types/generated_poc/enums/creative_agent_capability.py

@@ -8,7 +8,7 @@ from enum import Enum
 
 
 class CreativeAgentCapability(Enum):
-    validation = 'validation'
-    assembly = 'assembly'
-    generation = 'generation'
-    preview = 'preview'
+    validation = "validation"
+    assembly = "assembly"
+    generation = "generation"
+    preview = "preview"

adcp/types/generated_poc/enums/creative_sort_field.py

@@ -8,9 +8,9 @@ from enum import Enum
 
 
 class CreativeSortField(Enum):
-    created_date = 'created_date'
-    updated_date = 'updated_date'
-    name = 'name'
-    status = 'status'
-    assignment_count = 'assignment_count'
-    performance_score = 'performance_score'
+    created_date = "created_date"
+    updated_date = "updated_date"
+    name = "name"
+    status = "status"
+    assignment_count = "assignment_count"
+    performance_score = "performance_score"

adcp/types/generated_poc/enums/creative_status.py

@@ -8,7 +8,7 @@ from enum import Enum
 
 
 class CreativeStatus(Enum):
-    processing = 'processing'
-    approved = 'approved'
-    rejected = 'rejected'
-    pending_review = 'pending_review'
+    processing = "processing"
+    approved = "approved"
+    rejected = "rejected"
+    pending_review = "pending_review"