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

adcp/types/generated_poc/core/identifier.py

@@ -0,0 +1,27 @@
+# generated by datamodel-codegen:
+#   filename:  core/identifier.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 ..enums import identifier_types
+
+
+class Identifier(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    type: Annotated[
+        identifier_types.PropertyIdentifierTypes, Field(description='Type of identifier')
+    ]
+    value: Annotated[
+        str,
+        Field(
+            description="The identifier value. For domain type: 'example.com' matches base domain plus www and m subdomains; 'edition.example.com' matches that specific subdomain; '*.example.com' matches ALL subdomains but NOT base domain"
+        ),
+    ]

adcp/types/generated_poc/core/mcp_webhook_payload.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/mcp_webhook_payload.json
-#   timestamp: 2025-12-11T15:09:37+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/measurement.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/measurement.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/media_buy.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/media_buy.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

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
 

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
 

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
 

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.',
+            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
 

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

adcp/types/generated_poc/core/product_filters.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/product_filters.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-26T11:40:01+00:00
 
 from __future__ import annotations
 
@@ -8,12 +8,12 @@ from datetime import date
 from typing import Annotated
 
 from adcp.types.base import AdCPBaseModel
-from pydantic import ConfigDict, Field, RootModel
+from pydantic import AnyUrl, ConfigDict, Field, RootModel
 
 from ..enums import channels as channels_1
 from ..enums import delivery_type as delivery_type_1
-from ..enums import format_category
-from . import format_id
+from ..enums import format_category, geo_level, metro_system
+from . import format_id, media_buy_features
 
 
 class BudgetRange(AdCPBaseModel):
@@ -48,6 +48,38 @@ class Country(RootModel[str]):
     root: Annotated[str, Field(pattern='^[A-Z]{2}$')]
 
 
+class Metro(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    code: Annotated[
+        str, Field(description="Metro code within the system (e.g., '501' for NYC DMA)")
+    ]
+    system: Annotated[
+        metro_system.MetroAreaSystem, Field(description='Metro classification system')
+    ]
+
+
+class Region(RootModel[str]):
+    root: Annotated[str, Field(pattern='^[A-Z]{2}-[A-Z0-9]+$')]
+
+
+class RequiredGeoTargetingItem(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    level: Annotated[
+        geo_level.GeographicTargetingLevel,
+        Field(description='Geographic targeting level (country, region, metro, postal_area)'),
+    ]
+    system: Annotated[
+        str | None,
+        Field(
+            description="Classification system within the level. Required for metro (e.g., 'nielsen_dma') and postal_area (e.g., 'us_zip'). Not applicable for country/region which use ISO standards."
+        ),
+    ] = None
+
+
 class ProductFilters(AdCPBaseModel):
     model_config = ConfigDict(
         extra='allow',
@@ -57,13 +89,13 @@ class ProductFilters(AdCPBaseModel):
         Field(description='Budget range to filter appropriate products'),
     ] = None
     channels: Annotated[
-        list[channels_1.AdvertisingChannels] | None,
+        list[channels_1.MediaChannel] | None,
         Field(description="Filter by advertising channels (e.g., ['display', 'video', 'dooh'])"),
     ] = None
     countries: Annotated[
         list[Country] | None,
         Field(
-            description="Filter by target countries using ISO 3166-1 alpha-2 country codes (e.g., ['US', 'CA', 'GB'])"
+            description="Filter by country coverage using ISO 3166-1 alpha-2 codes (e.g., ['US', 'CA', 'GB']). Works for all inventory types."
         ),
     ] = None
     delivery_type: delivery_type_1.DeliveryType | None = None
@@ -80,12 +112,45 @@ class ProductFilters(AdCPBaseModel):
         list[format_category.FormatCategory] | None, Field(description='Filter by format types')
     ] = None
     is_fixed_price: Annotated[
-        bool | None, Field(description='Filter for fixed price vs auction products')
+        bool | None,
+        Field(
+            description='Filter by pricing availability: true = products offering fixed pricing (at least one option with fixed_price), false = products offering auction pricing (at least one option without fixed_price). Products with both fixed and auction options match both true and false.'
+        ),
+    ] = None
+    metros: Annotated[
+        list[Metro] | None,
+        Field(
+            description='Filter by metro coverage for locally-bound inventory (radio, DOOH, local TV). Use when products have DMA/metro-specific coverage. For digital inventory where products have broad coverage, use required_geo_targeting instead to filter by seller capability.'
+        ),
     ] = None
     min_exposures: Annotated[
         int | None,
         Field(description='Minimum exposures/impressions needed for measurement validity', ge=1),
     ] = None
+    regions: Annotated[
+        list[Region] | None,
+        Field(
+            description="Filter by region coverage using ISO 3166-2 codes (e.g., ['US-NY', 'US-CA', 'GB-SCT']). Use for locally-bound inventory (regional OOH, local TV) where products have region-specific coverage."
+        ),
+    ] = None
+    required_axe_integrations: Annotated[
+        list[AnyUrl] | None,
+        Field(
+            description='Filter to products executable through specific agentic ad exchanges. URLs are canonical identifiers.'
+        ),
+    ] = None
+    required_features: Annotated[
+        media_buy_features.MediaBuyFeatures | None,
+        Field(
+            description='Filter to products from sellers supporting specific protocol features. Only features set to true are used for filtering.'
+        ),
+    ] = None
+    required_geo_targeting: Annotated[
+        list[RequiredGeoTargetingItem] | None,
+        Field(
+            description='Filter to products from sellers supporting specific geo targeting capabilities. Each entry specifies a targeting level (country, region, metro, postal_area) and optionally a system for levels that have multiple classification systems.'
+        ),
+    ] = None
     standard_formats_only: Annotated[
         bool | None, Field(description='Only return products accepting IAB standard formats')
     ] = None

adcp/types/generated_poc/core/promoted_offerings.py

@@ -1,16 +1,16 @@
 # generated by datamodel-codegen:
 #   filename:  core/promoted_offerings.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
 from enum import Enum
-from typing import Annotated, Any
+from typing import Annotated
 
 from adcp.types.base import AdCPBaseModel
-from pydantic import ConfigDict, Field
+from pydantic import AnyUrl, ConfigDict, Field
 
-from . import brand_manifest_ref, promoted_products
+from . import brand_manifest_ref, offering, promoted_products
 
 
 class AssetType(Enum):
@@ -43,21 +43,6 @@ class AssetSelectors(AdCPBaseModel):
     ] = None
 
 
-class Offering(AdCPBaseModel):
-    model_config = ConfigDict(
-        extra='allow',
-    )
-    assets: Annotated[
-        list[dict[str, Any]] | None, Field(description='Assets specific to this offering')
-    ] = None
-    description: Annotated[str | None, Field(description="Description of what's being offered")] = (
-        None
-    )
-    name: Annotated[
-        str, Field(description="Offering name (e.g., 'Winter Sale', 'New Product Launch')")
-    ]
-
-
 class PromotedOfferings(AdCPBaseModel):
     model_config = ConfigDict(
         extra='allow',
@@ -73,9 +58,9 @@ class PromotedOfferings(AdCPBaseModel):
         ),
     ]
     offerings: Annotated[
-        list[Offering] | None,
+        list[offering.Offering] | None,
         Field(
-            description='Inline offerings for campaigns without a product catalog. Each offering has a name, description, and associated assets.'
+            description='Offerings available for promotion. Each offering can include creative assets (via portfolio_ref or inline assets) for traditional ads. When si_agent_url is set at the parent level, hosts can offer conversational experiences about any of these offerings.'
         ),
     ] = None
     product_selectors: Annotated[
@@ -84,3 +69,9 @@ class PromotedOfferings(AdCPBaseModel):
             description='Selectors to choose which products/offerings from the brand manifest product catalog to promote'
         ),
     ] = None
+    si_agent_url: Annotated[
+        AnyUrl | None,
+        Field(
+            description="MCP endpoint URL for the brand's SI agent. When present, hosts can connect users to conversational experiences about any of the offerings. The agent handles si_get_offering lookups and full conversations."
+        ),
+    ] = None

adcp/types/generated_poc/core/promoted_products.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/promoted_products.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/property.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/property.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/property_id.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/property_id.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/property_list_ref.py

@@ -0,0 +1,26 @@
+# generated by datamodel-codegen:
+#   filename:  core/property_list_ref.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 AnyUrl, ConfigDict, Field
+
+
+class PropertyListReference(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    agent_url: Annotated[AnyUrl, Field(description='URL of the agent managing the property list')]
+    auth_token: Annotated[
+        str | None,
+        Field(
+            description='JWT or other authorization token for accessing the list. Optional if the list is public or caller has implicit access.'
+        ),
+    ] = None
+    list_id: Annotated[
+        str, Field(description='Identifier for the property list within the agent', min_length=1)
+    ]

adcp/types/generated_poc/core/property_tag.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/property_tag.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/proposal.py

@@ -0,0 +1,64 @@
+# generated by datamodel-codegen:
+#   filename:  core/proposal.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 AwareDatetime, ConfigDict, Field
+
+from . import ext as ext_1
+from . import product_allocation
+
+
+class TotalBudgetGuidance(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    currency: Annotated[str | None, Field(description='ISO 4217 currency code')] = None
+    max: Annotated[
+        float | None, Field(description='Maximum budget before diminishing returns', ge=0.0)
+    ] = None
+    min: Annotated[float | None, Field(description='Minimum recommended budget', ge=0.0)] = None
+    recommended: Annotated[
+        float | None, Field(description='Recommended budget for optimal performance', ge=0.0)
+    ] = None
+
+
+class Proposal(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    allocations: Annotated[
+        list[product_allocation.ProductAllocation],
+        Field(
+            description='Budget allocations across products. Allocation percentages MUST sum to 100. Publishers are responsible for ensuring the sum equals 100; buyers SHOULD validate this before execution.',
+            min_length=1,
+        ),
+    ]
+    brief_alignment: Annotated[
+        str | None,
+        Field(description='Explanation of how this proposal aligns with the campaign brief'),
+    ] = None
+    description: Annotated[
+        str | None, Field(description='Explanation of the proposal strategy and what it achieves')
+    ] = None
+    expires_at: Annotated[
+        AwareDatetime | None,
+        Field(
+            description='When this proposal expires and can no longer be executed. After expiration, referenced products or pricing may no longer be available.'
+        ),
+    ] = None
+    ext: ext_1.ExtensionObject | None = None
+    name: Annotated[str, Field(description='Human-readable name for this media plan proposal')]
+    proposal_id: Annotated[
+        str,
+        Field(
+            description='Unique identifier for this proposal. Used to refine the proposal in subsequent get_products calls or to execute it via create_media_buy.'
+        ),
+    ]
+    total_budget_guidance: Annotated[
+        TotalBudgetGuidance | None, Field(description='Optional budget guidance for this proposal')
+    ] = None

adcp/types/generated_poc/core/protocol_envelope.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/protocol_envelope.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/publisher_property_selector.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/publisher_property_selector.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/push_notification_config.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/push_notification_config.json
-#   timestamp: 2025-12-18T20:00:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/core/reporting_capabilities.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/reporting_capabilities.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations