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

adcp/types/generated_poc/core/media_buy_features.py

@@ -0,0 +1,29 @@
+# generated by datamodel-codegen:
+#   filename:  core/media_buy_features.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import Field
+
+
+class MediaBuyFeatures(AdCPBaseModel):
+    content_standards: Annotated[
+        bool | None,
+        Field(
+            description='Full support for content_standards configuration including sampling rates and category filtering'
+        ),
+    ] = None
+    inline_creative_management: Annotated[
+        bool | None,
+        Field(description='Supports creatives provided inline in create_media_buy requests'),
+    ] = None
+    property_list_filtering: Annotated[
+        bool | None,
+        Field(
+            description='Honors property_list parameter in get_products to filter results to buyer-approved properties'
+        ),
+    ] = None

adcp/types/generated_poc/core/offering.py

@@ -0,0 +1,80 @@
+# generated by datamodel-codegen:
+#   filename:  core/offering.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from typing import Annotated, Any
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import AnyUrl, AwareDatetime, ConfigDict, Field
+
+from . import ext as ext_1
+
+
+class Offering(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    assets: Annotated[
+        list[dict[str, Any]] | None,
+        Field(description='Assets specific to this offering (images, videos, copy)'),
+    ] = None
+    categories: Annotated[
+        list[str] | None,
+        Field(
+            description="Categories this offering belongs to (e.g., 'measurement', 'identity', 'programmatic')"
+        ),
+    ] = None
+    checkout_url: Annotated[
+        AnyUrl | None,
+        Field(
+            description="URL for checkout/purchase flow when the brand doesn't support agentic checkout."
+        ),
+    ] = None
+    description: Annotated[str | None, Field(description="Description of what's being offered")] = (
+        None
+    )
+    ext: ext_1.ExtensionObject | None = None
+    keywords: Annotated[
+        list[str] | None,
+        Field(
+            description='Keywords for matching this offering to user intent. Hosts use these for retrieval/relevance scoring.'
+        ),
+    ] = None
+    landing_url: Annotated[
+        AnyUrl | None, Field(description='Landing page URL for this offering.')
+    ] = None
+    name: Annotated[
+        str,
+        Field(
+            description="Human-readable offering name (e.g., 'Winter Sale', 'Free Trial', 'Enterprise Platform')"
+        ),
+    ]
+    offering_id: Annotated[
+        str,
+        Field(
+            description='Unique identifier for this offering. Used by hosts to reference specific offerings in si_get_offering calls.'
+        ),
+    ]
+    portfolio_ref: Annotated[
+        AnyUrl | None,
+        Field(
+            description='Reference to a creative portfolio for this offering. Portfolios contain organized creative assets across formats, enabling consistent ad delivery for this specific offering.'
+        ),
+    ] = None
+    tagline: Annotated[
+        str | None, Field(description='Short promotional tagline for the offering')
+    ] = None
+    valid_from: Annotated[
+        AwareDatetime | None,
+        Field(
+            description='When the offering becomes available. If not specified, offering is immediately available.'
+        ),
+    ] = None
+    valid_to: Annotated[
+        AwareDatetime | None,
+        Field(
+            description='When the offering expires. If not specified, offering has no expiration.'
+        ),
+    ] = None

adcp/types/generated_poc/core/package.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/package.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -17,19 +17,19 @@ from . import format_id, targeting
 
 class Package(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     bid_price: Annotated[
         float | None,
         Field(
-            description="Bid price for auction-based CPM pricing (present if using cpm-auction-option)",
+            description='Bid price for auction-based CPM pricing (present if using cpm-auction-option)',
             ge=0.0,
         ),
     ] = None
     budget: Annotated[
         float | None,
         Field(
-            description="Budget allocation for this package in the currency specified by the pricing option",
+            description='Budget allocation for this package in the currency specified by the pricing option',
             ge=0.0,
         ),
     ] = None
@@ -38,22 +38,22 @@ class Package(AdCPBaseModel):
     ] = None
     creative_assignments: Annotated[
         list[creative_assignment.CreativeAssignment] | None,
-        Field(description="Creative assets assigned to this package"),
+        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"),
+        Field(description='Format IDs that creative assets will be provided for this package'),
     ] = None
     impressions: Annotated[
-        float | None, Field(description="Impression goal for this package", ge=0.0)
+        float | None, Field(description='Impression goal for this package', ge=0.0)
     ] = 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."
+            description='Whether this package is paused by the buyer. Paused packages do not deliver impressions. Defaults to false.'
         ),
     ] = False
     pricing_option_id: Annotated[
@@ -63,6 +63,6 @@ class Package(AdCPBaseModel):
         ),
     ] = None
     product_id: Annotated[
-        str | None, Field(description="ID of the product this package is based on")
+        str | None, Field(description='ID of the product this package is based on')
     ] = None
     targeting_overlay: targeting.TargetingOverlay | None = None

adcp/types/generated_poc/core/performance_feedback.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/performance_feedback.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -16,63 +16,63 @@ from ..enums import metric_type as metric_type_1
 
 class MeasurementPeriod(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     end: Annotated[
-        AwareDatetime, Field(description="ISO 8601 end timestamp for measurement period")
+        AwareDatetime, Field(description='ISO 8601 end timestamp for measurement period')
     ]
     start: Annotated[
-        AwareDatetime, Field(description="ISO 8601 start timestamp for measurement period")
+        AwareDatetime, Field(description='ISO 8601 start timestamp for measurement period')
     ]
 
 
 class Status(Enum):
-    accepted = "accepted"
-    queued = "queued"
-    applied = "applied"
-    rejected = "rejected"
+    accepted = 'accepted'
+    queued = 'queued'
+    applied = 'applied'
+    rejected = 'rejected'
 
 
 class PerformanceFeedback(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     applied_at: Annotated[
         AwareDatetime | None,
         Field(
-            description="ISO 8601 timestamp when feedback was applied to optimization algorithms"
+            description='ISO 8601 timestamp when feedback was applied to optimization algorithms'
         ),
     ] = None
     creative_id: Annotated[
-        str | None, Field(description="Specific creative asset (if feedback is creative-specific)")
+        str | None, Field(description='Specific creative asset (if feedback is creative-specific)')
     ] = None
     feedback_id: Annotated[
-        str, Field(description="Unique identifier for this performance feedback submission")
+        str, Field(description='Unique identifier for this performance feedback submission')
     ]
     feedback_source: Annotated[
-        feedback_source_1.FeedbackSource, Field(description="Source of the performance data")
+        feedback_source_1.FeedbackSource, Field(description='Source of the performance data')
     ]
     measurement_period: Annotated[
-        MeasurementPeriod, Field(description="Time period for performance measurement")
+        MeasurementPeriod, Field(description='Time period for performance measurement')
     ]
     media_buy_id: Annotated[str, Field(description="Publisher's media buy identifier")]
     metric_type: Annotated[
-        metric_type_1.MetricType, Field(description="The business metric being measured")
+        metric_type_1.MetricType, Field(description='The business metric being measured')
     ]
     package_id: Annotated[
         str | None,
         Field(
-            description="Specific package within the media buy (if feedback is package-specific)"
+            description='Specific package within the media buy (if feedback is package-specific)'
         ),
     ] = None
     performance_index: Annotated[
         float,
         Field(
-            description="Normalized performance score (0.0 = no value, 1.0 = expected, >1.0 = above expected)",
+            description='Normalized performance score (0.0 = no value, 1.0 = expected, >1.0 = above expected)',
             ge=0.0,
         ),
     ]
-    status: Annotated[Status, Field(description="Processing status of the performance feedback")]
+    status: Annotated[Status, Field(description='Processing status of the performance feedback')]
     submitted_at: Annotated[
-        AwareDatetime, Field(description="ISO 8601 timestamp when feedback was submitted")
+        AwareDatetime, Field(description='ISO 8601 timestamp when feedback was submitted')
     ]

adcp/types/generated_poc/core/placement.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/placement.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -14,15 +14,15 @@ from . import format_id
 
 class Placement(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     description: Annotated[
-        str | None, Field(description="Detailed description of where and how the placement appears")
+        str | None, Field(description='Detailed description of where and how the placement appears')
     ] = None
     format_ids: Annotated[
         list[format_id.FormatId] | None,
         Field(
-            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).",
+            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
@@ -33,5 +33,5 @@ class Placement(AdCPBaseModel):
         ),
     ]
     placement_id: Annotated[
-        str, Field(description="Unique identifier for the placement within the product")
+        str, Field(description='Unique identifier for the placement within the product')
     ]

adcp/types/generated_poc/core/pricing_option.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/pricing_option.json
-#   timestamp: 2025-12-11T15:09:37+00:00
+#   timestamp: 2026-01-26T11:40:01+00:00
 
 from __future__ import annotations
 
@@ -11,22 +11,18 @@ from pydantic import Field, RootModel
 from ..pricing_options import (
     cpc_option,
     cpcv_option,
-    cpm_auction_option,
-    cpm_fixed_option,
+    cpm_option,
     cpp_option,
     cpv_option,
     flat_rate_option,
-    vcpm_auction_option,
-    vcpm_fixed_option,
+    vcpm_option,
 )
 
 
 class PricingOption(
     RootModel[
-        cpm_fixed_option.CpmFixedRatePricingOption
-        | cpm_auction_option.CpmAuctionPricingOption
-        | vcpm_fixed_option.VcpmFixedRatePricingOption
-        | vcpm_auction_option.VcpmAuctionPricingOption
+        cpm_option.CpmPricingOption
+        | vcpm_option.VcpmPricingOption
         | cpc_option.CpcPricingOption
         | cpcv_option.CpcvPricingOption
         | cpv_option.CpvPricingOption
@@ -35,17 +31,15 @@ class PricingOption(
     ]
 ):
     root: Annotated[
-        cpm_fixed_option.CpmFixedRatePricingOption
-        | cpm_auction_option.CpmAuctionPricingOption
-        | vcpm_fixed_option.VcpmFixedRatePricingOption
-        | vcpm_auction_option.VcpmAuctionPricingOption
+        cpm_option.CpmPricingOption
+        | vcpm_option.VcpmPricingOption
         | cpc_option.CpcPricingOption
         | cpcv_option.CpcvPricingOption
         | cpv_option.CpvPricingOption
         | cpp_option.CppPricingOption
         | flat_rate_option.FlatRatePricingOption,
         Field(
-            description="A pricing model option offered by a publisher for a product. Each pricing model has its own schema with model-specific requirements.",
-            title="Pricing Option",
+            description="A pricing model option offered by a publisher for a product. Discriminated by pricing_model field. If fixed_price is present, it's fixed pricing. If absent, it's auction-based (floor_price and price_guidance optional).",
+            title='Pricing Option',
         ),
     ]

adcp/types/generated_poc/core/product.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/product.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -35,100 +35,100 @@ class DeliveryMeasurement(AdCPBaseModel):
 
 class ProductCard(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     format_id: Annotated[
         format_id_1.FormatId,
         Field(
-            description="Creative format defining the card layout (typically product_card_standard)"
+            description='Creative format defining the card layout (typically product_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 ProductCardDetailed(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     format_id: Annotated[
         format_id_1.FormatId,
         Field(
-            description="Creative format defining the detailed card layout (typically product_card_detailed)"
+            description='Creative format defining the detailed card layout (typically product_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'
         ),
     ]
 
 
 class Product(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     brief_relevance: Annotated[
         str | None,
         Field(
-            description="Explanation of why this product matches the brief (only included when brief is provided)"
+            description='Explanation of why this product matches the brief (only included when brief is provided)'
         ),
     ] = None
     creative_policy: creative_policy_1.CreativePolicy | None = None
     delivery_measurement: Annotated[
         DeliveryMeasurement,
         Field(
-            description="Measurement provider and methodology for delivery metrics. The buyer accepts the declared provider as the source of truth for the buy. REQUIRED for all products."
+            description='Measurement provider and methodology for delivery metrics. The buyer accepts the declared provider as the source of truth for the buy. REQUIRED for all products.'
         ),
     ]
     delivery_type: delivery_type_1.DeliveryType
     description: Annotated[
-        str, Field(description="Detailed description of the product and its inventory")
+        str, Field(description='Detailed description of the product and its inventory')
     ]
     estimated_exposures: Annotated[
         int | None,
-        Field(description="Estimated exposures/impressions for guaranteed products", ge=0),
+        Field(description='Estimated exposures/impressions for guaranteed products', ge=0),
     ] = None
     expires_at: Annotated[
-        AwareDatetime | None, Field(description="Expiration timestamp for custom products")
+        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(
-            description="Array of supported creative format IDs - structured format_id objects with agent_url and id"
+            description='Array of supported creative format IDs - structured format_id objects with agent_url and id'
         ),
     ]
-    is_custom: Annotated[bool | None, Field(description="Whether this is a custom product")] = None
+    is_custom: Annotated[bool | None, Field(description='Whether this is a custom product')] = None
     measurement: measurement_1.Measurement | None = None
-    name: Annotated[str, Field(description="Human-readable product name")]
+    name: Annotated[str, Field(description='Human-readable product name')]
     placements: Annotated[
         list[placement.Placement] | None,
         Field(
-            description="Optional array of specific placements within this product. When provided, buyers can target specific placements when assigning creatives.",
+            description='Optional array of specific placements within this product. When provided, buyers can target specific placements when assigning creatives.',
             min_length=1,
         ),
     ] = None
     pricing_options: Annotated[
         list[pricing_option.PricingOption],
-        Field(description="Available pricing models for this product", min_length=1),
+        Field(description='Available pricing models for this product', min_length=1),
     ]
     product_card: Annotated[
         ProductCard | None,
         Field(
-            description="Optional standard visual card (300x400px) for displaying this product in user interfaces. Can be rendered via preview_creative or pre-generated."
+            description='Optional standard visual card (300x400px) for displaying this product in user interfaces. Can be rendered via preview_creative or pre-generated.'
         ),
     ] = None
     product_card_detailed: Annotated[
         ProductCardDetailed | None,
         Field(
-            description="Optional detailed card with carousel and full specifications. Provides rich product presentation similar to media kit pages."
+            description='Optional detailed card with carousel and full specifications. Provides rich product presentation similar to media kit pages.'
         ),
     ] = None
-    product_id: Annotated[str, Field(description="Unique identifier for the product")]
+    product_id: Annotated[str, Field(description='Unique identifier for the product')]
     publisher_properties: Annotated[
         list[publisher_property_selector.PublisherPropertySelector],
         Field(

adcp/types/generated_poc/core/product_allocation.py

@@ -0,0 +1,48 @@
+# generated by datamodel-codegen:
+#   filename:  core/product_allocation.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import ConfigDict, Field
+
+from . import ext as ext_1
+
+
+class ProductAllocation(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    allocation_percentage: Annotated[
+        float,
+        Field(
+            description='Percentage of total budget allocated to this product (0-100)',
+            ge=0.0,
+            le=100.0,
+        ),
+    ]
+    ext: ext_1.ExtensionObject | None = None
+    pricing_option_id: Annotated[
+        str | None,
+        Field(description="Recommended pricing option ID from the product's pricing_options array"),
+    ] = None
+    product_id: Annotated[
+        str, Field(description='ID of the product (must reference a product in the products array)')
+    ]
+    rationale: Annotated[
+        str | None,
+        Field(description='Explanation of why this product and allocation are recommended'),
+    ] = None
+    sequence: Annotated[
+        int | None,
+        Field(description='Optional ordering hint for multi-line-item plans (1-based)', ge=1),
+    ] = None
+    tags: Annotated[
+        list[str] | None,
+        Field(
+            description="Categorical tags for this allocation (e.g., 'desktop', 'german', 'mobile') - useful for grouping/filtering allocations by dimension"
+        ),
+    ] = None