adcp 2.6.0__py3-none-any.whl → 2.8.0__py3-none-any.whl

adcp/types/aliases.py

@@ -31,7 +31,6 @@ immediately rather than at runtime when users try to use the aliases.
 
 from __future__ import annotations
 
-# Import all generated types that need semantic aliases
 from adcp.types._generated import (
     # Activation responses
     ActivateSignalResponse1,
@@ -39,6 +38,11 @@ from adcp.types._generated import (
     # Activation keys
     ActivationKey1,
     ActivationKey2,
+    # Authorized agents
+    AuthorizedAgents,
+    AuthorizedAgents1,
+    AuthorizedAgents2,
+    AuthorizedAgents3,
     # Build creative responses
     BuildCreativeResponse1,
     BuildCreativeResponse2,
@@ -64,6 +68,9 @@ from adcp.types._generated import (
     PreviewRender1,
     PreviewRender2,
     PreviewRender3,
+    # Publisher properties types
+    PropertyId,
+    PropertyTag,
     # Performance feedback responses
     ProvidePerformanceFeedbackResponse1,
     ProvidePerformanceFeedbackResponse2,
@@ -83,26 +90,23 @@ from adcp.types._generated import (
     VastAsset1,
     VastAsset2,
 )
-
-# Import Package types directly from their modules to avoid collision issues
-from adcp.types.generated_poc.create_media_buy_response import (
-    Package as CreatedPackageInternal,
+from adcp.types._generated import (
+    PublisherPropertySelector1 as PublisherPropertiesInternal,
 )
-from adcp.types.generated_poc.package import Package as FullPackageInternal
-
-# Import PublisherProperties types and related types from product module
-from adcp.types.generated_poc.product import (
-    PropertyId,
-    PropertyTag,
+from adcp.types._generated import (
+    PublisherPropertySelector2 as PublisherPropertiesByIdInternal,
 )
-from adcp.types.generated_poc.product import (
-    PublisherProperties as PublisherPropertiesInternal,
+from adcp.types._generated import (
+    PublisherPropertySelector3 as PublisherPropertiesByTagInternal,
 )
-from adcp.types.generated_poc.product import (
-    PublisherProperties4 as PublisherPropertiesByIdInternal,
+
+# Import all generated types that need semantic aliases
+from adcp.types._generated import (
+    # Package types (from name collision resolution)
+    _PackageFromCreateMediaBuyResponse as CreatedPackageInternal,
 )
-from adcp.types.generated_poc.product import (
-    PublisherProperties5 as PublisherPropertiesByTagInternal,
+from adcp.types._generated import (
+    _PackageFromPackage as FullPackageInternal,
 )
 
 # ============================================================================
@@ -480,6 +484,226 @@ Example:
     ```
 """
 
+# ============================================================================
+# AUTHORIZED AGENTS ALIASES - Authorization Type Discriminated Unions
+# ============================================================================
+# The AdCP adagents.json schema defines AuthorizedAgents as a discriminated
+# union with four variants based on the `authorization_type` field:
+#
+# 1. Property IDs (authorization_type='property_ids'):
+#    - Agent authorized for specific property IDs
+#    - Requires property_ids array
+#
+# 2. Property Tags (authorization_type='property_tags'):
+#    - Agent authorized for properties matching tags
+#    - Requires property_tags array
+#
+# 3. Inline Properties (authorization_type='inline_properties'):
+#    - Agent authorized with inline property definitions
+#    - Requires properties array with full Property objects
+#
+# 4. Publisher Properties (authorization_type='publisher_properties'):
+#    - Agent authorized for properties from other publisher domains
+#    - Requires publisher_properties array
+#
+# These define which sales agents are authorized to sell inventory and which
+# properties they can access.
+
+AuthorizedAgentsByPropertyId = AuthorizedAgents
+"""Authorized agent with specific property IDs.
+
+This variant uses authorization_type='property_ids' for agents authorized
+to sell specific properties identified by their IDs.
+
+Fields:
+- authorization_type: Literal['property_ids']
+- authorized_for: Human-readable description
+- property_ids: List of PropertyId (non-empty)
+- url: Agent's API endpoint URL
+
+Example:
+    ```python
+    from adcp.types.aliases import AuthorizedAgentsByPropertyId, PropertyId
+
+    agent = AuthorizedAgentsByPropertyId(
+        authorization_type="property_ids",
+        authorized_for="Premium display inventory",
+        property_ids=[PropertyId("homepage"), PropertyId("sports")],
+        url="https://agent.example.com"
+    )
+    ```
+"""
+
+AuthorizedAgentsByPropertyTag = AuthorizedAgents1
+"""Authorized agent with property tags.
+
+This variant uses authorization_type='property_tags' for agents authorized
+to sell properties identified by matching tags.
+
+Fields:
+- authorization_type: Literal['property_tags']
+- authorized_for: Human-readable description
+- property_tags: List of PropertyTag (non-empty)
+- url: Agent's API endpoint URL
+
+Example:
+    ```python
+    from adcp.types.aliases import AuthorizedAgentsByPropertyTag, PropertyTag
+
+    agent = AuthorizedAgentsByPropertyTag(
+        authorization_type="property_tags",
+        authorized_for="Video inventory",
+        property_tags=[PropertyTag("video"), PropertyTag("premium")],
+        url="https://agent.example.com"
+    )
+    ```
+"""
+
+AuthorizedAgentsByInlineProperties = AuthorizedAgents2
+"""Authorized agent with inline property definitions.
+
+This variant uses authorization_type='inline_properties' for agents with
+inline Property objects rather than references to the top-level properties array.
+
+Fields:
+- authorization_type: Literal['inline_properties']
+- authorized_for: Human-readable description
+- properties: List of Property objects (non-empty)
+- url: Agent's API endpoint URL
+
+Example:
+    ```python
+    from adcp.types.aliases import AuthorizedAgentsByInlineProperties
+    from adcp.types.stable import Property
+
+    agent = AuthorizedAgentsByInlineProperties(
+        authorization_type="inline_properties",
+        authorized_for="Custom inventory bundle",
+        properties=[...],  # Full Property objects
+        url="https://agent.example.com"
+    )
+    ```
+"""
+
+AuthorizedAgentsByPublisherProperties = AuthorizedAgents3
+"""Authorized agent for properties from other publishers.
+
+This variant uses authorization_type='publisher_properties' for agents
+authorized to sell inventory from other publisher domains.
+
+Fields:
+- authorization_type: Literal['publisher_properties']
+- authorized_for: Human-readable description
+- publisher_properties: List of PublisherPropertySelector variants (non-empty)
+- url: Agent's API endpoint URL
+
+Example:
+    ```python
+    from adcp.types.aliases import (
+        AuthorizedAgentsByPublisherProperties,
+        PublisherPropertiesAll
+    )
+
+    agent = AuthorizedAgentsByPublisherProperties(
+        authorization_type="publisher_properties",
+        authorized_for="Network inventory across publishers",
+        publisher_properties=[
+            PublisherPropertiesAll(
+                publisher_domain="publisher1.com",
+                selection_type="all"
+            )
+        ],
+        url="https://agent.example.com"
+    )
+    ```
+"""
+
+# ============================================================================
+# UNION TYPE ALIASES - For Type Hints and Pattern Matching
+# ============================================================================
+# These union aliases provide convenient types for function signatures,
+# type hints, and pattern matching without having to manually construct
+# the union each time.
+
+# Deployment union (for signals)
+Deployment = PlatformDeployment | AgentDeployment
+"""Union type for all deployment variants.
+
+Use this for type hints when a function accepts any deployment type:
+
+Example:
+    ```python
+    def process_deployment(deployment: Deployment) -> None:
+        if isinstance(deployment, PlatformDeployment):
+            print(f"Platform: {deployment.platform}")
+        elif isinstance(deployment, AgentDeployment):
+            print(f"Agent: {deployment.agent_url}")
+    ```
+"""
+
+# Destination union (for signals)
+Destination = PlatformDestination | AgentDestination
+"""Union type for all destination variants.
+
+Use this for type hints when a function accepts any destination type:
+
+Example:
+    ```python
+    def format_destination(dest: Destination) -> str:
+        if isinstance(dest, PlatformDestination):
+            return f"Platform: {dest.platform}"
+        elif isinstance(dest, AgentDestination):
+            return f"Agent: {dest.agent_url}"
+    ```
+"""
+
+# Authorized agent union (for adagents.json)
+AuthorizedAgent = (
+    AuthorizedAgentsByPropertyId
+    | AuthorizedAgentsByPropertyTag
+    | AuthorizedAgentsByInlineProperties
+    | AuthorizedAgentsByPublisherProperties
+)
+"""Union type for all authorized agent variants.
+
+Use this for type hints when processing agents from adagents.json:
+
+Example:
+    ```python
+    def validate_agent(agent: AuthorizedAgent) -> bool:
+        match agent.authorization_type:
+            case "property_ids":
+                return len(agent.property_ids) > 0
+            case "property_tags":
+                return len(agent.property_tags) > 0
+            case "inline_properties":
+                return len(agent.properties) > 0
+            case "publisher_properties":
+                return len(agent.publisher_properties) > 0
+    ```
+"""
+
+# Publisher properties union (for product requests)
+PublisherProperties = (
+    PublisherPropertiesAll | PublisherPropertiesById | PublisherPropertiesByTag
+)
+"""Union type for all publisher properties variants.
+
+Use this for type hints in product filtering:
+
+Example:
+    ```python
+    def filter_products(props: PublisherProperties) -> None:
+        match props.selection_type:
+            case "all":
+                print("All properties from publisher")
+            case "by_id":
+                print(f"Properties: {props.property_ids}")
+            case "by_tag":
+                print(f"Tags: {props.property_tags}")
+    ```
+"""
+
 # ============================================================================
 # EXPORTS
 # ============================================================================
@@ -501,6 +725,13 @@ __all__ = [
     "UrlDaastAsset",
     "UrlPreviewRender",
     "UrlVastAsset",
+    # Authorized agent variants
+    "AuthorizedAgentsByPropertyId",
+    "AuthorizedAgentsByPropertyTag",
+    "AuthorizedAgentsByInlineProperties",
+    "AuthorizedAgentsByPublisherProperties",
+    # Authorized agent union
+    "AuthorizedAgent",
     # Build creative responses
     "BuildCreativeSuccessResponse",
     "BuildCreativeErrorResponse",
@@ -531,14 +762,20 @@ __all__ = [
     # Publisher properties types
     "PropertyId",
     "PropertyTag",
-    # Publisher properties aliases
+    # Publisher properties variants
     "PublisherPropertiesAll",
     "PublisherPropertiesById",
     "PublisherPropertiesByTag",
-    # Deployment aliases
+    # Publisher properties union
+    "PublisherProperties",
+    # Deployment variants
     "PlatformDeployment",
     "AgentDeployment",
-    # Destination aliases
+    # Deployment union
+    "Deployment",
+    # Destination variants
     "PlatformDestination",
     "AgentDestination",
+    # Destination union
+    "Destination",
 ]

adcp/types/generated_poc/adagents.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  adagents.json
-#   timestamp: 2025-11-18T03:35:10+00:00
+#   timestamp: 2025-11-19T02:02:39+00:00
 
 from __future__ import annotations
 
@@ -9,7 +9,7 @@ from typing import Annotated, Literal
 from adcp.types.base import AdCPBaseModel
 from pydantic import AnyUrl, AwareDatetime, ConfigDict, EmailStr, Field, RootModel
 
-from . import property
+from . import property, publisher_property_selector
 
 
 class PropertyId(RootModel[str]):
@@ -72,81 +72,6 @@ class AuthorizedAgents1(AdCPBaseModel):
     url: Annotated[AnyUrl, Field(description="The authorized agent's API endpoint URL")]
 
 
-class PublisherProperties(AdCPBaseModel):
-    model_config = ConfigDict(
-        extra='forbid',
-    )
-    property_ids: Annotated[
-        list[PropertyId],
-        Field(
-            description="Specific property IDs from the publisher's adagents.json properties array",
-            min_length=1,
-        ),
-    ]
-    publisher_domain: Annotated[
-        str,
-        Field(
-            description="Domain where the publisher's adagents.json is hosted (e.g., 'cnn.com')",
-            pattern='^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$',
-        ),
-    ]
-    selection_type: Annotated[
-        Literal['by_id'],
-        Field(description='Discriminator indicating selection by specific property IDs'),
-    ]
-
-
-class PublisherProperties1(AdCPBaseModel):
-    model_config = ConfigDict(
-        extra='forbid',
-    )
-    property_tags: Annotated[
-        list[PropertyTag],
-        Field(
-            description="Property tags from the publisher's adagents.json tags. Agent is authorized for all properties with these tags",
-            min_length=1,
-        ),
-    ]
-    publisher_domain: Annotated[
-        str,
-        Field(
-            description="Domain where the publisher's adagents.json is hosted (e.g., 'cnn.com')",
-            pattern='^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$',
-        ),
-    ]
-    selection_type: Annotated[
-        Literal['by_tag'], Field(description='Discriminator indicating selection by property tags')
-    ]
-
-
-class AuthorizedAgents3(AdCPBaseModel):
-    model_config = ConfigDict(
-        extra='forbid',
-    )
-    authorization_type: Annotated[
-        Literal['publisher_properties'],
-        Field(
-            description='Discriminator indicating authorization for properties from other publisher domains'
-        ),
-    ]
-    authorized_for: Annotated[
-        str,
-        Field(
-            description='Human-readable description of what this agent is authorized to sell',
-            max_length=500,
-            min_length=1,
-        ),
-    ]
-    publisher_properties: Annotated[
-        list[PublisherProperties | PublisherProperties1],
-        Field(
-            description='Properties from other publisher domains this agent is authorized for. Each entry specifies a publisher domain and which of their properties this agent can sell',
-            min_length=1,
-        ),
-    ]
-    url: Annotated[AnyUrl, Field(description="The authorized agent's API endpoint URL")]
-
-
 class Contact(AdCPBaseModel):
     model_config = ConfigDict(
         extra='forbid',
@@ -226,6 +151,38 @@ class AuthorizedAgents2(AdCPBaseModel):
     url: Annotated[AnyUrl, Field(description="The authorized agent's API endpoint URL")]
 
 
+class AuthorizedAgents3(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    authorization_type: Annotated[
+        Literal['publisher_properties'],
+        Field(
+            description='Discriminator indicating authorization for properties from other publisher domains'
+        ),
+    ]
+    authorized_for: Annotated[
+        str,
+        Field(
+            description='Human-readable description of what this agent is authorized to sell',
+            max_length=500,
+            min_length=1,
+        ),
+    ]
+    publisher_properties: Annotated[
+        list[
+            publisher_property_selector.PublisherPropertySelector1
+            | publisher_property_selector.PublisherPropertySelector2
+            | publisher_property_selector.PublisherPropertySelector3
+        ],
+        Field(
+            description='Properties from other publisher domains this agent is authorized for. Each entry specifies a publisher domain and which of their properties this agent can sell',
+            min_length=1,
+        ),
+    ]
+    url: Annotated[AnyUrl, Field(description="The authorized agent's API endpoint URL")]
+
+
 class AuthorizedSalesAgents(AdCPBaseModel):
     model_config = ConfigDict(
         extra='forbid',

adcp/types/generated_poc/product.py

@@ -1,13 +1,13 @@
 # generated by datamodel-codegen:
 #   filename:  product.json
-#   timestamp: 2025-11-18T05:05:53+00:00
+#   timestamp: 2025-11-19T02:02:39+00:00
 
 from __future__ import annotations
 
-from typing import Annotated, Any, Literal
+from typing import Annotated, Any
 
 from adcp.types.base import AdCPBaseModel
-from pydantic import AwareDatetime, ConfigDict, Field, RootModel
+from pydantic import AwareDatetime, ConfigDict, Field
 
 from . import cpc_option, cpcv_option, cpm_auction_option, cpm_fixed_option, cpp_option, cpv_option
 from . import creative_policy as creative_policy_1
@@ -15,7 +15,7 @@ from . import delivery_type as delivery_type_1
 from . import flat_rate_option
 from . import format_id as format_id_1
 from . import measurement as measurement_1
-from . import placement
+from . import placement, publisher_property_selector
 from . import reporting_capabilities as reporting_capabilities_1
 from . import vcpm_auction_option, vcpm_fixed_option
 
@@ -69,77 +69,6 @@ class ProductCardDetailed(AdCPBaseModel):
     ]
 
 
-class PublisherProperties(AdCPBaseModel):
-    model_config = ConfigDict(
-        extra='forbid',
-    )
-    publisher_domain: Annotated[
-        str,
-        Field(
-            description="Domain where publisher's adagents.json is hosted (e.g., 'cnn.com')",
-            pattern='^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$',
-        ),
-    ]
-    selection_type: Annotated[
-        Literal['all'],
-        Field(
-            description='Discriminator indicating all properties from this publisher are included'
-        ),
-    ]
-
-
-class PropertyId(RootModel[str]):
-    root: Annotated[str, Field(pattern='^[a-z0-9_]+$')]
-
-
-class PublisherProperties4(AdCPBaseModel):
-    model_config = ConfigDict(
-        extra='forbid',
-    )
-    property_ids: Annotated[
-        list[PropertyId],
-        Field(description="Specific property IDs from the publisher's adagents.json", min_length=1),
-    ]
-    publisher_domain: Annotated[
-        str,
-        Field(
-            description="Domain where publisher's adagents.json is hosted (e.g., 'cnn.com')",
-            pattern='^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$',
-        ),
-    ]
-    selection_type: Annotated[
-        Literal['by_id'],
-        Field(description='Discriminator indicating selection by specific property IDs'),
-    ]
-
-
-class PropertyTag(PropertyId):
-    pass
-
-
-class PublisherProperties5(AdCPBaseModel):
-    model_config = ConfigDict(
-        extra='forbid',
-    )
-    property_tags: Annotated[
-        list[PropertyTag],
-        Field(
-            description="Property tags from the publisher's adagents.json. Product covers all properties with these tags",
-            min_length=1,
-        ),
-    ]
-    publisher_domain: Annotated[
-        str,
-        Field(
-            description="Domain where publisher's adagents.json is hosted (e.g., 'cnn.com')",
-            pattern='^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$',
-        ),
-    ]
-    selection_type: Annotated[
-        Literal['by_tag'], Field(description='Discriminator indicating selection by property tags')
-    ]
-
-
 class Product(AdCPBaseModel):
     model_config = ConfigDict(
         extra='forbid',
@@ -212,7 +141,11 @@ class Product(AdCPBaseModel):
     ] = None
     product_id: Annotated[str, Field(description='Unique identifier for the product')]
     publisher_properties: Annotated[
-        list[PublisherProperties | PublisherProperties4 | PublisherProperties5],
+        list[
+            publisher_property_selector.PublisherPropertySelector1
+            | publisher_property_selector.PublisherPropertySelector2
+            | publisher_property_selector.PublisherPropertySelector3
+        ],
         Field(
             description="Publisher properties covered by this product. Buyers fetch actual property definitions from each publisher's adagents.json and validate agent authorization. Selection patterns mirror the authorization patterns in adagents.json for consistency.",
             min_length=1,

adcp/types/generated_poc/publisher_property_selector.py

@@ -0,0 +1,81 @@
+# generated by datamodel-codegen:
+#   filename:  publisher-property-selector.json
+#   timestamp: 2025-11-19T02:02:39+00:00
+
+from __future__ import annotations
+
+from typing import Annotated, Literal
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import ConfigDict, Field, RootModel
+
+
+class PublisherPropertySelector1(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    publisher_domain: Annotated[
+        str,
+        Field(
+            description="Domain where publisher's adagents.json is hosted (e.g., 'cnn.com')",
+            pattern='^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$',
+        ),
+    ]
+    selection_type: Annotated[
+        Literal['all'],
+        Field(
+            description='Discriminator indicating all properties from this publisher are included'
+        ),
+    ]
+
+
+class PropertyId(RootModel[str]):
+    root: Annotated[str, Field(pattern='^[a-z0-9_]+$')]
+
+
+class PublisherPropertySelector2(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    property_ids: Annotated[
+        list[PropertyId],
+        Field(description="Specific property IDs from the publisher's adagents.json", min_length=1),
+    ]
+    publisher_domain: Annotated[
+        str,
+        Field(
+            description="Domain where publisher's adagents.json is hosted (e.g., 'cnn.com')",
+            pattern='^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$',
+        ),
+    ]
+    selection_type: Annotated[
+        Literal['by_id'],
+        Field(description='Discriminator indicating selection by specific property IDs'),
+    ]
+
+
+class PropertyTag(PropertyId):
+    pass
+
+
+class PublisherPropertySelector3(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    property_tags: Annotated[
+        list[PropertyTag],
+        Field(
+            description="Property tags from the publisher's adagents.json. Selector covers all properties with these tags",
+            min_length=1,
+        ),
+    ]
+    publisher_domain: Annotated[
+        str,
+        Field(
+            description="Domain where publisher's adagents.json is hosted (e.g., 'cnn.com')",
+            pattern='^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$',
+        ),
+    ]
+    selection_type: Annotated[
+        Literal['by_tag'], Field(description='Discriminator indicating selection by property tags')
+    ]