adcp 2.11.1__py3-none-any.whl → 2.12.1__py3-none-any.whl

adcp/types/generated_poc/{creative_filters.py → core/creative_filters.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  creative-filters.json
-#   timestamp: 2025-11-21T12:49:05+00:00
+#   filename:  core/creative_filters.json
+#   timestamp: 2025-11-22T16:02:47+00:00
 
 from __future__ import annotations
 
@@ -9,7 +9,7 @@ from typing import Annotated
 from adcp.types.base import AdCPBaseModel
 from pydantic import AwareDatetime, ConfigDict, Field
 
-from . import creative_status
+from ..enums import creative_status
 
 
 class CreativeFilters(AdCPBaseModel):
@@ -22,6 +22,12 @@ class CreativeFilters(AdCPBaseModel):
     assigned_to_packages: Annotated[
         list[str] | None, Field(description='Filter creatives assigned to any of these packages')
     ] = None
+    buyer_refs: Annotated[
+        list[str] | None,
+        Field(
+            description='Filter creatives assigned to media buys with any of these buyer references'
+        ),
+    ] = None
     created_after: Annotated[
         AwareDatetime | None,
         Field(description='Filter creatives created after this date (ISO 8601)'),
@@ -43,6 +49,9 @@ class CreativeFilters(AdCPBaseModel):
     has_performance_data: Annotated[
         bool | None, Field(description='Filter creatives that have performance data when true')
     ] = None
+    media_buy_ids: Annotated[
+        list[str] | None, Field(description='Filter creatives assigned to any of these media buys')
+    ] = None
     name_contains: Annotated[
         str | None,
         Field(description='Filter by creative names containing this text (case-insensitive)'),

adcp/types/generated_poc/{creative_manifest.py → core/creative_manifest.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  creative-manifest.json
-#   timestamp: 2025-11-18T03:35:10+00:00
+#   filename:  core/creative_manifest.json
+#   timestamp: 2025-11-22T19:54:03+00:00
 
 from __future__ import annotations
 
@@ -9,13 +9,16 @@ from typing import Annotated
 from adcp.types.base import AdCPBaseModel
 from pydantic import ConfigDict, Field
 
-from . import audio_asset, css_asset, daast_asset
+from . import ext as ext_1
 from . import format_id as format_id_1
-from . import (
+from . import promoted_offerings
+from .assets import (
+    audio_asset,
+    css_asset,
+    daast_asset,
     html_asset,
     image_asset,
     javascript_asset,
-    promoted_offerings,
     text_asset,
     url_asset,
     vast_asset,
@@ -50,8 +53,12 @@ class CreativeManifest(AdCPBaseModel):
             description="Map of asset IDs to actual asset content. Each key MUST match an asset_id from the format's assets_required array (e.g., 'banner_image', 'clickthrough_url', 'video_file', 'vast_tag'). The asset_id is the technical identifier used to match assets to format requirements.\n\nIMPORTANT: Creative manifest validation MUST be performed in the context of the format specification. The format defines what type each asset_id should be, which eliminates any validation ambiguity."
         ),
     ]
+    ext: ext_1.ExtensionObject | None = None
     format_id: Annotated[
-        format_id_1.FormatId, Field(description='Format identifier this manifest is for')
+        format_id_1.FormatId,
+        Field(
+            description="Format identifier this manifest is for. Can be a template format (id only) or a deterministic format (id + dimensions/duration). For dimension-specific creatives, include width/height/unit in the format_id to create a unique identifier (e.g., {id: 'display_static', width: 300, height: 250, unit: 'px'})."
+        ),
     ]
     promoted_offering: Annotated[
         str | None,

adcp/types/generated_poc/{creative_policy.py → core/creative_policy.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  creative-policy.json
-#   timestamp: 2025-11-21T12:49:05+00:00
+#   filename:  core/creative_policy.json
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations
 
@@ -9,7 +9,7 @@ from typing import Annotated
 from adcp.types.base import AdCPBaseModel
 from pydantic import ConfigDict, Field
 
-from . import co_branding_requirement, landing_page_requirement
+from ..enums import co_branding_requirement, landing_page_requirement
 
 
 class CreativePolicy(AdCPBaseModel):

adcp/types/generated_poc/{delivery_metrics.py → core/delivery_metrics.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  delivery-metrics.json
-#   timestamp: 2025-11-18T03:35:10+00:00
+#   filename:  core/delivery_metrics.json
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/{deployment.py → core/deployment.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  deployment.json
-#   timestamp: 2025-11-20T20:44:40+00:00
+#   filename:  core/deployment.json
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/{destination.py → core/destination.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  destination.json
-#   timestamp: 2025-11-20T20:44:40+00:00
+#   filename:  core/destination.json
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/dimensions.py

@@ -0,0 +1,18 @@
+# generated by datamodel-codegen:
+#   filename:  core/dimensions.json
+#   timestamp: 2025-11-22T19:16:02+00:00
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import ConfigDict, Field
+
+
+class Dimensions(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    height: Annotated[int, Field(description='Height in pixels', ge=1)]
+    width: Annotated[int, Field(description='Width in pixels', ge=1)]

adcp/types/generated_poc/{error.py → core/error.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  error.json
-#   timestamp: 2025-11-18T03:35:10+00:00
+#   filename:  core/error.json
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/ext.py

@@ -0,0 +1,15 @@
+# generated by datamodel-codegen:
+#   filename:  core/ext.json
+#   timestamp: 2025-11-22T15:23:24+00:00
+
+from __future__ import annotations
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import ConfigDict
+
+
+class ExtensionObject(AdCPBaseModel):
+    pass
+    model_config = ConfigDict(
+        extra='allow',
+    )

adcp/types/generated_poc/{format.py → core/format.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  format.json
-#   timestamp: 2025-11-21T12:49:05+00:00
+#   filename:  core/format.json
+#   timestamp: 2025-11-22T19:54:03+00:00
 
 from __future__ import annotations
 
@@ -9,7 +9,7 @@ from typing import Annotated, Any, Literal
 from adcp.types.base import AdCPBaseModel
 from pydantic import AnyUrl, ConfigDict, Field
 
-from . import asset_content_type, dimension_unit, format_category
+from ..enums import asset_content_type, format_category, format_id_parameter
 from . import format_id as format_id_1
 
 
@@ -35,7 +35,7 @@ class AssetsRequired(AdCPBaseModel):
     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.). For template formats, use parameters_from_format_id: true to indicate asset parameters must match the format_id parameters (width/height/unit and/or duration_ms).'
         ),
     ] = None
 
@@ -53,7 +53,10 @@ class Asset(AdCPBaseModel):
         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. For template formats, use parameters_from_format_id: true to indicate asset parameters must match the format_id parameters (width/height/unit and/or duration_ms).'
+        ),
     ] = None
 
 
@@ -70,40 +73,6 @@ class AssetsRequired1(AdCPBaseModel):
     min_count: Annotated[int, Field(description='Minimum number of repetitions required', ge=1)]
 
 
-class FormatCard(AdCPBaseModel):
-    model_config = ConfigDict(
-        extra='forbid',
-    )
-    format_id: Annotated[
-        format_id_1.FormatId,
-        Field(
-            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'),
-    ]
-
-
-class FormatCardDetailed(AdCPBaseModel):
-    model_config = ConfigDict(
-        extra='forbid',
-    )
-    format_id: Annotated[
-        format_id_1.FormatId,
-        Field(
-            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'
-        ),
-    ]
-
-
 class Responsive(AdCPBaseModel):
     height: bool
     width: bool
@@ -117,34 +86,56 @@ class Dimensions(AdCPBaseModel):
             pattern='^\\d+:\\d+$',
         ),
     ] = None
-    height: Annotated[
-        float | None, Field(description='Fixed height in specified units', ge=0.0)
-    ] = None
+    height: Annotated[int | None, Field(description='Fixed height in pixels', ge=1)] = None
     max_height: Annotated[
-        float | None, Field(description='Maximum height for responsive renders', ge=0.0)
+        int | None, Field(description='Maximum height in pixels for responsive renders', ge=1)
     ] = None
     max_width: Annotated[
-        float | None, Field(description='Maximum width for responsive renders', ge=0.0)
+        int | None, Field(description='Maximum width in pixels for responsive renders', ge=1)
     ] = None
     min_height: Annotated[
-        float | None, Field(description='Minimum height for responsive renders', ge=0.0)
+        int | None, Field(description='Minimum height in pixels for responsive renders', ge=1)
     ] = None
     min_width: Annotated[
-        float | None, Field(description='Minimum width for responsive renders', ge=0.0)
+        int | None, Field(description='Minimum width in pixels for responsive renders', ge=1)
     ] = None
     responsive: Annotated[
         Responsive | None, Field(description='Indicates which dimensions are responsive/fluid')
     ] = None
-    unit: Annotated[
-        dimension_unit.DimensionUnit, Field(description='Unit of measurement for dimensions')
+    width: Annotated[int | None, Field(description='Fixed width in pixels', ge=1)] = None
+
+
+class Renders(AdCPBaseModel):
+    dimensions: Annotated[
+        Dimensions, Field(description='Dimensions for this rendered piece (in pixels)')
+    ]
+    parameters_from_format_id: Annotated[
+        bool | None,
+        Field(
+            description='When true, parameters for this render (dimensions and/or duration) are specified in the format_id. Used for template formats that accept parameters. Mutually exclusive with specifying dimensions object explicitly.'
+        ),
+    ] = None
+    role: Annotated[
+        str,
+        Field(
+            description="Semantic role of this rendered piece (e.g., 'primary', 'companion', 'mobile_variant')"
+        ),
     ]
-    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')]
+Dimensions2 = Dimensions
+
+
+class Renders1(AdCPBaseModel):
+    dimensions: Annotated[
+        Dimensions2 | None, Field(description='Dimensions for this rendered piece (in pixels)')
+    ] = None
+    parameters_from_format_id: Annotated[
+        Literal[True],
+        Field(
+            description='When true, parameters for this render (dimensions and/or duration) are specified in the format_id. Used for template formats that accept parameters. Mutually exclusive with specifying dimensions object explicitly.'
+        ),
+    ]
     role: Annotated[
         str,
         Field(
@@ -153,10 +144,50 @@ class Render(AdCPBaseModel):
     ]
 
 
+class FormatCard(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    format_id: Annotated[
+        format_id_1.FormatId,
+        Field(
+            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'),
+    ]
+
+
+class FormatCardDetailed(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    format_id: Annotated[
+        format_id_1.FormatId,
+        Field(
+            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'
+        ),
+    ]
+
+
 class Format(AdCPBaseModel):
     model_config = ConfigDict(
         extra='forbid',
     )
+    accepts_parameters: Annotated[
+        list[format_id_parameter.FormatIdParameter] | None,
+        Field(
+            description='List of parameters this format accepts in format_id. Template formats define which parameters (dimensions, duration, etc.) can be specified when instantiating the format. Empty or omitted means this is a concrete format with fixed parameters.'
+        ),
+    ] = None
     assets_required: Annotated[
         list[AssetsRequired | AssetsRequired1] | None,
         Field(
@@ -209,7 +240,7 @@ class Format(AdCPBaseModel):
         ),
     ] = None
     renders: Annotated[
-        list[Render] | None,
+        list[Renders | Renders1] | 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.',
             min_length=1,

adcp/types/generated_poc/core/format_id.py

@@ -0,0 +1,50 @@
+# generated by datamodel-codegen:
+#   filename:  core/format_id.json
+#   timestamp: 2025-11-22T19:54:03+00:00
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import AnyUrl, ConfigDict, Field
+
+
+class FormatId(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    agent_url: Annotated[
+        AnyUrl,
+        Field(
+            description="URL of the agent that defines this format (e.g., 'https://creatives.adcontextprotocol.org' for standard formats, or 'https://publisher.com/.well-known/adcp/sales' for custom formats)"
+        ),
+    ]
+    duration_ms: Annotated[
+        float | None,
+        Field(
+            description='Duration in milliseconds for time-based formats (video, audio). When specified, creates a parameterized format ID. Omit to reference a template format without parameters.',
+            ge=1.0,
+        ),
+    ] = None
+    height: Annotated[
+        int | None,
+        Field(
+            description='Height in pixels for visual formats. When specified, width must also be specified. Both fields together create a parameterized format ID for dimension-specific variants.',
+            ge=1,
+        ),
+    ] = None
+    id: Annotated[
+        str,
+        Field(
+            description="Format identifier within the agent's namespace (e.g., 'display_static', 'video_hosted', 'audio_standard'). When used alone, references a template format. When combined with dimension/duration fields, creates a parameterized format ID for a specific variant.",
+            pattern='^[a-zA-Z0-9_-]+$',
+        ),
+    ]
+    width: Annotated[
+        int | None,
+        Field(
+            description='Width in pixels for visual formats. When specified, height must also be specified. Both fields together create a parameterized format ID for dimension-specific variants.',
+            ge=1,
+        ),
+    ] = None

adcp/types/generated_poc/{frequency_cap.py → core/frequency_cap.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  frequency-cap.json
-#   timestamp: 2025-11-18T03:35:10+00:00
+#   filename:  core/frequency_cap.json
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/{measurement.py → core/measurement.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  measurement.json
-#   timestamp: 2025-11-18T03:35:10+00:00
+#   filename:  core/measurement.json
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/{media_buy.py → core/media_buy.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  media-buy.json
-#   timestamp: 2025-11-18T03:35:10+00:00
+#   filename:  core/media_buy.json
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations
 
@@ -9,7 +9,9 @@ from typing import Annotated
 from adcp.types.base import AdCPBaseModel
 from pydantic import AwareDatetime, ConfigDict, Field
 
-from . import media_buy_status, package
+from ..enums import media_buy_status
+from . import ext as ext_1
+from . import package
 
 
 class MediaBuy(AdCPBaseModel):
@@ -23,6 +25,7 @@ class MediaBuy(AdCPBaseModel):
     creative_deadline: Annotated[
         AwareDatetime | None, Field(description='ISO 8601 timestamp for creative upload deadline')
     ] = None
+    ext: ext_1.ExtensionObject | None = None
     media_buy_id: Annotated[
         str, Field(description="Publisher's unique identifier for the media buy")
     ]

adcp/types/generated_poc/{package.py → core/package.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  package.json
-#   timestamp: 2025-11-18T03:35:10+00:00
+#   filename:  core/package.json
+#   timestamp: 2025-11-22T19:54:03+00:00
 
 from __future__ import annotations
 
@@ -9,9 +9,10 @@ from typing import Annotated
 from adcp.types.base import AdCPBaseModel
 from pydantic import ConfigDict, Field
 
-from . import creative_assignment, format_id
-from . import pacing as pacing_1
-from . import package_status, targeting
+from ..enums import pacing as pacing_1
+from . import creative_assignment
+from . import ext as ext_1
+from . import format_id, targeting
 
 
 class Package(AdCPBaseModel):
@@ -39,6 +40,7 @@ class Package(AdCPBaseModel):
         list[creative_assignment.CreativeAssignment] | None,
         Field(description='Creative assets assigned to this package'),
     ] = None
+    ext: ext_1.ExtensionObject | None = None
     format_ids_to_provide: Annotated[
         list[format_id.FormatId] | None,
         Field(description='Format IDs that creative assets will be provided for this package'),
@@ -48,6 +50,12 @@ class Package(AdCPBaseModel):
     ] = None
     pacing: pacing_1.Pacing | None = None
     package_id: Annotated[str, Field(description="Publisher's unique identifier for the package")]
+    paused: Annotated[
+        bool | None,
+        Field(
+            description='Whether this package is paused by the buyer. Paused packages do not deliver impressions. Defaults to false.'
+        ),
+    ] = False
     pricing_option_id: Annotated[
         str | None,
         Field(
@@ -57,5 +65,4 @@ class Package(AdCPBaseModel):
     product_id: Annotated[
         str | None, Field(description='ID of the product this package is based on')
     ] = None
-    status: package_status.PackageStatus
     targeting_overlay: targeting.TargetingOverlay | None = None

adcp/types/generated_poc/{performance_feedback.py → core/performance_feedback.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  performance-feedback.json
-#   timestamp: 2025-11-21T12:49:05+00:00
+#   filename:  core/performance_feedback.json
+#   timestamp: 2025-11-22T15:23:24+00:00
 
 from __future__ import annotations
 
@@ -10,8 +10,8 @@ from typing import Annotated
 from adcp.types.base import AdCPBaseModel
 from pydantic import AwareDatetime, ConfigDict, Field
 
-from . import feedback_source as feedback_source_1
-from . import metric_type as metric_type_1
+from ..enums import feedback_source as feedback_source_1
+from ..enums import metric_type as metric_type_1
 
 
 class MeasurementPeriod(AdCPBaseModel):

adcp/types/generated_poc/{placement.py → core/placement.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  placement.json
-#   timestamp: 2025-11-18T03:35:10+00:00
+#   filename:  core/placement.json
+#   timestamp: 2025-11-22T19:54:03+00:00
 
 from __future__ import annotations
 
@@ -22,7 +22,7 @@ class Placement(AdCPBaseModel):
     format_ids: Annotated[
         list[format_id.FormatId] | None,
         Field(
-            description="Format IDs supported by this specific placement (subset of product's formats)",
+            description='Format IDs supported by this specific placement. Can include: (1) concrete format_ids (fixed dimensions), (2) template format_ids without parameters (accepts any dimensions/duration), or (3) parameterized format_ids (specific dimension/duration constraints).',
             min_length=1,
         ),
     ] = None

adcp/types/generated_poc/{product.py → core/product.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  product.json
-#   timestamp: 2025-11-19T02:02:39+00:00
+#   filename:  core/product.json
+#   timestamp: 2025-11-22T19:54:03+00:00
 
 from __future__ import annotations
 
@@ -9,15 +9,24 @@ from typing import Annotated, Any
 from adcp.types.base import AdCPBaseModel
 from pydantic import AwareDatetime, ConfigDict, Field
 
-from . import cpc_option, cpcv_option, cpm_auction_option, cpm_fixed_option, cpp_option, cpv_option
+from ..enums import delivery_type as delivery_type_1
+from ..pricing_options import (
+    cpc_option,
+    cpcv_option,
+    cpm_auction_option,
+    cpm_fixed_option,
+    cpp_option,
+    cpv_option,
+    flat_rate_option,
+    vcpm_auction_option,
+    vcpm_fixed_option,
+)
 from . import creative_policy as creative_policy_1
-from . import delivery_type as delivery_type_1
-from . import flat_rate_option
+from . import ext as ext_1
 from . import format_id as format_id_1
 from . import measurement as measurement_1
 from . import placement, publisher_property_selector
 from . import reporting_capabilities as reporting_capabilities_1
-from . import vcpm_auction_option, vcpm_fixed_option
 
 
 class DeliveryMeasurement(AdCPBaseModel):
@@ -97,6 +106,7 @@ class Product(AdCPBaseModel):
     expires_at: Annotated[
         AwareDatetime | None, Field(description='Expiration timestamp for custom products')
     ] = None
+    ext: ext_1.ExtensionObject | None = None
     format_ids: Annotated[
         list[format_id_1.FormatId],
         Field(