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

adcp/__init__.py

@@ -101,23 +101,33 @@ from adcp.types._generated import TaskStatus as GeneratedTaskStatus
 from adcp.types.aliases import (
     ActivateSignalErrorResponse,
     ActivateSignalSuccessResponse,
+    AgentDeployment,
+    AgentDestination,
     BothPreviewRender,
     BuildCreativeErrorResponse,
     BuildCreativeSuccessResponse,
+    CreatedPackageReference,
     CreateMediaBuyErrorResponse,
     CreateMediaBuySuccessResponse,
     HtmlPreviewRender,
     InlineDaastAsset,
     InlineVastAsset,
     MediaSubAsset,
+    PlatformDeployment,
+    PlatformDestination,
     PreviewCreativeFormatRequest,
     PreviewCreativeInteractiveResponse,
     PreviewCreativeManifestRequest,
     PreviewCreativeStaticResponse,
+    PropertyId,
     PropertyIdActivationKey,
+    PropertyTag,
     PropertyTagActivationKey,
     ProvidePerformanceFeedbackErrorResponse,
     ProvidePerformanceFeedbackSuccessResponse,
+    PublisherPropertiesAll,
+    PublisherPropertiesById,
+    PublisherPropertiesByTag,
     SyncCreativesErrorResponse,
     SyncCreativesSuccessResponse,
     TextSubAsset,
@@ -164,7 +174,7 @@ from adcp.validation import (
     validate_publisher_properties_item,
 )
 
-__version__ = "2.4.1"
+__version__ = "2.6.0"
 
 __all__ = [
     # Client classes
@@ -213,6 +223,8 @@ __all__ = [
     "CreativeManifest",
     "MediaBuy",
     "Package",
+    # Package type aliases
+    "CreatedPackageReference",
     # Status enums (for control flow)
     "CreativeStatus",
     "MediaBuyStatus",
@@ -278,6 +290,8 @@ __all__ = [
     # Semantic type aliases (for better API ergonomics)
     "ActivateSignalSuccessResponse",
     "ActivateSignalErrorResponse",
+    "AgentDeployment",
+    "AgentDestination",
     "BothPreviewRender",
     "BuildCreativeSuccessResponse",
     "BuildCreativeErrorResponse",
@@ -287,14 +301,21 @@ __all__ = [
     "InlineDaastAsset",
     "InlineVastAsset",
     "MediaSubAsset",
+    "PlatformDeployment",
+    "PlatformDestination",
     "PreviewCreativeFormatRequest",
     "PreviewCreativeManifestRequest",
     "PreviewCreativeStaticResponse",
     "PreviewCreativeInteractiveResponse",
+    "PropertyId",
     "PropertyIdActivationKey",
+    "PropertyTag",
     "PropertyTagActivationKey",
     "ProvidePerformanceFeedbackSuccessResponse",
     "ProvidePerformanceFeedbackErrorResponse",
+    "PublisherPropertiesAll",
+    "PublisherPropertiesById",
+    "PublisherPropertiesByTag",
     "SyncCreativesSuccessResponse",
     "SyncCreativesErrorResponse",
     "TextSubAsset",

adcp/types/__init__.py

@@ -12,10 +12,16 @@ adcp.types or adcp.types.stable for stable, versioned types.
 
 from adcp.types.aliases import (
     BothPreviewRender,
+    CreatedPackageReference,
     HtmlPreviewRender,
     InlineDaastAsset,
     InlineVastAsset,
     MediaSubAsset,
+    PropertyId,
+    PropertyTag,
+    PublisherPropertiesAll,
+    PublisherPropertiesById,
+    PublisherPropertiesByTag,
     TextSubAsset,
     UrlDaastAsset,
     UrlPreviewRender,
@@ -86,6 +92,15 @@ __all__ = [
     "UrlDaastAsset",
     "UrlPreviewRender",
     "UrlVastAsset",
+    # Package type aliases
+    "CreatedPackageReference",
+    # Publisher properties types
+    "PropertyId",
+    "PropertyTag",
+    # Publisher properties aliases
+    "PublisherPropertiesAll",
+    "PublisherPropertiesById",
+    "PublisherPropertiesByTag",
     # Stable API types (commonly used)
     "BrandManifest",
     "Creative",

adcp/types/_generated.py

@@ -10,7 +10,7 @@ Auto-generated by datamodel-code-generator from JSON schemas.
 DO NOT EDIT MANUALLY.
 
 Generated from: https://github.com/adcontextprotocol/adcp/tree/main/schemas
-Generation date: 2025-11-18 12:11:55 UTC
+Generation date: 2025-11-18 12:52:17 UTC
 """
 # ruff: noqa: E501, I001
 from __future__ import annotations

adcp/types/aliases.py

@@ -48,6 +48,12 @@ from adcp.types._generated import (
     # DAAST assets
     DaastAsset1,
     DaastAsset2,
+    # Deployment types
+    Deployment1,
+    Deployment2,
+    # Destination types
+    Destination1,
+    Destination2,
     # Preview creative requests
     PreviewCreativeRequest1,
     PreviewCreativeRequest2,
@@ -78,6 +84,27 @@ from adcp.types._generated import (
     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_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_poc.product import (
+    PublisherProperties as PublisherPropertiesInternal,
+)
+from adcp.types.generated_poc.product import (
+    PublisherProperties4 as PublisherPropertiesByIdInternal,
+)
+from adcp.types.generated_poc.product import (
+    PublisherProperties5 as PublisherPropertiesByTagInternal,
+)
+
 # ============================================================================
 # RESPONSE TYPE ALIASES - Success/Error Discriminated Unions
 # ============================================================================
@@ -201,6 +228,258 @@ MediaSubAsset = SubAsset1
 TextSubAsset = SubAsset2
 """SubAsset for text content (headlines, body text) - asset_kind='text', provides content."""
 
+# ============================================================================
+# PACKAGE TYPE ALIASES - Resolving Type Name Collisions
+# ============================================================================
+# The AdCP schemas define two genuinely different types both named "Package":
+#
+# 1. Full Package (from package.json schema):
+#    - Complete operational package with all fields (budget, pricing_option_id, etc.)
+#    - Used in MediaBuy, update operations, and package management
+#    - Has 12+ fields for full package configuration
+#
+# 2. Created Package (from create-media-buy-response.json schema):
+#    - Minimal response type with only IDs (buyer_ref, package_id)
+#    - Used in CreateMediaBuy success responses
+#    - Only 2 fields - represents newly created package references
+#
+# The code generator's "first wins" collision handling exports the Created Package
+# as "Package", shadowing the Full Package. These semantic aliases provide clear,
+# unambiguous names for both types.
+
+Package = FullPackageInternal
+"""Complete package configuration with all operational fields.
+
+This is the canonical Package type used throughout AdCP for package management.
+
+Used in:
+- MediaBuy.packages (list of full package details)
+- Update operations (modifying existing packages)
+- Package management (creating/configuring packages)
+
+Fields include: budget, pricing_option_id, product_id, status, bid_price,
+creative_assignments, format_ids_to_provide, impressions, pacing, targeting_overlay
+"""
+
+CreatedPackageReference = CreatedPackageInternal
+"""Minimal package reference with only IDs returned after creation.
+
+This is NOT the full Package type - it's a lightweight reference returned
+in CreateMediaBuySuccessResponse to indicate which packages were created.
+
+Used in:
+- CreateMediaBuySuccessResponse.packages (list of created package references)
+
+Fields: buyer_ref, package_id only
+"""
+
+# ============================================================================
+# PUBLISHER PROPERTIES ALIASES - Selection Type Discriminated Unions
+# ============================================================================
+# The AdCP schemas define PublisherProperties as a discriminated union with
+# three variants based on the `selection_type` field:
+#
+# 1. All Properties (selection_type='all'):
+#    - Includes all properties from the publisher
+#    - Only requires publisher_domain
+#
+# 2. By ID (selection_type='by_id'):
+#    - Specific properties selected by property_id
+#    - Requires publisher_domain + property_ids array
+#
+# 3. By Tag (selection_type='by_tag'):
+#    - Properties selected by tags
+#    - Requires publisher_domain + property_tags array
+#
+# These semantic aliases match the discriminator values and make code more
+# readable when constructing or pattern-matching publisher properties.
+
+PublisherPropertiesAll = PublisherPropertiesInternal
+"""Publisher properties covering all properties from the publisher.
+
+This variant uses selection_type='all' and includes all properties listed
+in the publisher's adagents.json file.
+
+Fields:
+- publisher_domain: Domain where adagents.json is hosted
+- selection_type: Literal['all']
+
+Example:
+    ```python
+    from adcp import PublisherPropertiesAll
+
+    props = PublisherPropertiesAll(
+        publisher_domain="example.com",
+        selection_type="all"
+    )
+    ```
+"""
+
+PublisherPropertiesById = PublisherPropertiesByIdInternal
+"""Publisher properties selected by specific property IDs.
+
+This variant uses selection_type='by_id' and specifies an explicit list
+of property IDs from the publisher's adagents.json file.
+
+Fields:
+- publisher_domain: Domain where adagents.json is hosted
+- selection_type: Literal['by_id']
+- property_ids: List of PropertyId (non-empty)
+
+Example:
+    ```python
+    from adcp import PublisherPropertiesById, PropertyId
+
+    props = PublisherPropertiesById(
+        publisher_domain="example.com",
+        selection_type="by_id",
+        property_ids=[PropertyId("homepage"), PropertyId("sports_section")]
+    )
+    ```
+"""
+
+PublisherPropertiesByTag = PublisherPropertiesByTagInternal
+"""Publisher properties selected by tags.
+
+This variant uses selection_type='by_tag' and specifies property tags.
+The product covers all properties in the publisher's adagents.json that
+have these tags.
+
+Fields:
+- publisher_domain: Domain where adagents.json is hosted
+- selection_type: Literal['by_tag']
+- property_tags: List of PropertyTag (non-empty)
+
+Example:
+    ```python
+    from adcp import PublisherPropertiesByTag, PropertyTag
+
+    props = PublisherPropertiesByTag(
+        publisher_domain="example.com",
+        selection_type="by_tag",
+        property_tags=[PropertyTag("premium"), PropertyTag("video")]
+    )
+    ```
+"""
+
+# ============================================================================
+# DEPLOYMENT & DESTINATION ALIASES - Signal Deployment Type Discriminated Unions
+# ============================================================================
+# The AdCP schemas define Deployment and Destination as discriminated unions
+# with two variants based on the `type` field:
+#
+# Deployment (where a signal is activated):
+# - Platform (type='platform'): DSP platform with platform ID
+# - Agent (type='agent'): Sales agent with agent URL
+#
+# Destination (where a signal can be activated):
+# - Platform (type='platform'): Target DSP platform
+# - Agent (type='agent'): Target sales agent
+#
+# These are used in GetSignalsResponse to describe signal availability and
+# activation status across different advertising platforms and agents.
+
+PlatformDeployment = Deployment1
+"""Signal deployment to a DSP platform.
+
+This variant uses type='platform' for platform-based signal deployments
+like The Trade Desk, Amazon DSP, etc.
+
+Fields:
+- type: Literal['platform']
+- platform: Platform identifier (e.g., 'the-trade-desk')
+- account: Optional account identifier
+- is_live: Whether signal is currently active
+- deployed_at: Activation timestamp if live
+- activation_key: Targeting key if live and accessible
+- estimated_activation_duration_minutes: Time to complete activation
+
+Example:
+    ```python
+    from adcp import PlatformDeployment
+
+    deployment = PlatformDeployment(
+        type="platform",
+        platform="the-trade-desk",
+        account="advertiser-123",
+        is_live=True,
+        deployed_at=datetime.now(timezone.utc)
+    )
+    ```
+"""
+
+AgentDeployment = Deployment2
+"""Signal deployment to a sales agent.
+
+This variant uses type='agent' for agent-based signal deployments
+using agent URLs.
+
+Fields:
+- type: Literal['agent']
+- agent_url: URL identifying the destination agent
+- account: Optional account identifier
+- is_live: Whether signal is currently active
+- deployed_at: Activation timestamp if live
+- activation_key: Targeting key if live and accessible
+- estimated_activation_duration_minutes: Time to complete activation
+
+Example:
+    ```python
+    from adcp import AgentDeployment
+
+    deployment = AgentDeployment(
+        type="agent",
+        agent_url="https://agent.example.com",
+        is_live=False,
+        estimated_activation_duration_minutes=30.0
+    )
+    ```
+"""
+
+PlatformDestination = Destination1
+"""Available signal destination on a DSP platform.
+
+This variant uses type='platform' for platform-based signal destinations.
+
+Fields:
+- type: Literal['platform']
+- platform: Platform identifier (e.g., 'the-trade-desk', 'amazon-dsp')
+- account: Optional account identifier on the platform
+
+Example:
+    ```python
+    from adcp import PlatformDestination
+
+    destination = PlatformDestination(
+        type="platform",
+        platform="the-trade-desk",
+        account="advertiser-123"
+    )
+    ```
+"""
+
+AgentDestination = Destination2
+"""Available signal destination via a sales agent.
+
+This variant uses type='agent' for agent-based signal destinations.
+
+Fields:
+- type: Literal['agent']
+- agent_url: URL identifying the destination agent
+- account: Optional account identifier on the agent
+
+Example:
+    ```python
+    from adcp import AgentDestination
+
+    destination = AgentDestination(
+        type="agent",
+        agent_url="https://agent.example.com",
+        account="partner-456"
+    )
+    ```
+"""
+
 # ============================================================================
 # EXPORTS
 # ============================================================================
@@ -246,4 +525,20 @@ __all__ = [
     # Update media buy responses
     "UpdateMediaBuySuccessResponse",
     "UpdateMediaBuyErrorResponse",
+    # Package type aliases
+    "CreatedPackageReference",
+    "Package",
+    # Publisher properties types
+    "PropertyId",
+    "PropertyTag",
+    # Publisher properties aliases
+    "PublisherPropertiesAll",
+    "PublisherPropertiesById",
+    "PublisherPropertiesByTag",
+    # Deployment aliases
+    "PlatformDeployment",
+    "AgentDeployment",
+    # Destination aliases
+    "PlatformDestination",
+    "AgentDestination",
 ]

adcp/types/stable.py

@@ -21,7 +21,6 @@ Schema Evolution:
 
 from __future__ import annotations
 
-# Import all generated types from internal consolidated module
 from adcp.types._generated import (
     # Core request/response types
     ActivateSignalRequest,
@@ -67,7 +66,6 @@ from adcp.types._generated import (
     MarkdownAsset,
     MediaBuy,
     MediaBuyStatus,
-    Package,
     PackageStatus,
     PreviewCreativeRequest,
     PreviewCreativeResponse,
@@ -94,6 +92,10 @@ from adcp.types._generated import (
     WebhookAsset,
 )
 
+# Import all generated types from internal consolidated module
+# Import Package directly from its module to avoid collision with Response Package
+from adcp.types.generated_poc.package import Package
+
 # Note: BrandManifest is currently split into BrandManifest1/2 due to upstream schema
 # using anyOf incorrectly. This will be fixed upstream to create a single BrandManifest type.
 # For now, users should use BrandManifest1 (url required) which is most common.

{adcp-2.4.1.dist-info → adcp-2.6.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: adcp
-Version: 2.4.1
+Version: 2.6.0
 Summary: Official Python client for the Ad Context Protocol (AdCP)
 Author-email: AdCP Community <maintainers@adcontextprotocol.org>
 License: Apache-2.0
@@ -35,6 +35,8 @@ Requires-Dist: mypy>=1.0.0; extra == "dev"
 Requires-Dist: black>=23.0.0; extra == "dev"
 Requires-Dist: ruff>=0.1.0; extra == "dev"
 Requires-Dist: datamodel-code-generator[http]>=0.35.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: pdoc3>=0.10.0; extra == "docs"
 Dynamic: license-file
 
 # adcp - Python Client for Ad Context Protocol
@@ -177,6 +179,18 @@ async with ADCPMultiAgentClient(
 # Connections automatically cleaned up here
 ```
 
+## Documentation
+
+- **[API Reference](https://adcontextprotocol.github.io/adcp-client-python/)** - Complete API documentation with type signatures and examples
+- **[Protocol Spec](https://github.com/adcontextprotocol/adcp)** - Ad Context Protocol specification
+- **[Examples](examples/)** - Code examples and usage patterns
+
+The API reference documentation is automatically generated from the code and includes:
+- Full type signatures for all methods
+- Field descriptions from JSON Schema
+- Method documentation with examples
+- Searchable interface
+
 ## Features
 
 ### Test Helpers
@@ -801,6 +815,7 @@ Apache 2.0 License - see [LICENSE](LICENSE) file for details.
 
 ## Support
 
-- **Documentation**: [docs.adcontextprotocol.org](https://docs.adcontextprotocol.org)
+- **API Reference**: [adcontextprotocol.github.io/adcp-client-python](https://adcontextprotocol.github.io/adcp-client-python/)
+- **Protocol Documentation**: [docs.adcontextprotocol.org](https://docs.adcontextprotocol.org)
 - **Issues**: [GitHub Issues](https://github.com/adcontextprotocol/adcp-client-python/issues)
 - **Protocol Spec**: [AdCP Specification](https://github.com/adcontextprotocol/adcp)

{adcp-2.4.1.dist-info → adcp-2.6.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-adcp/__init__.py,sha256=2ZLisXqlBpyfz7EqJMNgmpPsYWWM-Mbe0NNitcdIiuw,8505
+adcp/__init__.py,sha256=WTIxgfr9VU1apx9J6AinZ3xwV61Z2O0smUnQEdEarmY,9034
 adcp/__main__.py,sha256=YF2GUXF1LICW1TPxNQiGIfSp5cpAsejoEG2fuOgbzrc,12839
 adcp/adagents.py,sha256=o-vTBmdZvu9aER-TAlLLL3s-WGYY8N67jnrAH24lST8,22333
 adcp/client.py,sha256=Z70D0bHcLNmr0NBGXbFUvW8dBdzHkcv8CmFcYo3pIjw,28803
@@ -13,12 +13,12 @@ adcp/protocols/base.py,sha256=vBHD23Fzl_CCk_Gy9nvSbBYopcJlYkYyzoz-rhI8wHg,5214
 adcp/protocols/mcp.py,sha256=d9uSpGd0BKvQ0JxztkfDvHwoDrDYhuiw5oivpYOAbmM,16647
 adcp/testing/__init__.py,sha256=ZWp_floWjVZfy8RBG5v_FUXQ8YbN7xjXvVcX-_zl_HU,1416
 adcp/testing/test_helpers.py,sha256=-UKuxxyKQald5EvXxguQH34b3J0JdsxKH_nRT6GTjkQ,10029
-adcp/types/__init__.py,sha256=evh_YdppRd55wiOop5RR7FMbxfQD_7ejcFc5g5HjZIo,2521
-adcp/types/_generated.py,sha256=srPaLXmb8nQ4mkfuFNU87t_77k6ZrDyIFNHZLpqPLO8,14926
-adcp/types/aliases.py,sha256=Rj5_0Lo62RrNglrPMtYptVZkNSgcigFGyUVuG82k_2w,9013
+adcp/types/__init__.py,sha256=V_Tme95-OoTGZkrMTQwNP76cN5QelO-Q-9sRTg-EBIA,2926
+adcp/types/_generated.py,sha256=p4U_P3BROGjCnS0Cd2o9ZJ_bShQLffB3D9_0D29JB0g,14926
+adcp/types/aliases.py,sha256=puqrz_cwlfSq6Td78EIaWtDUzcsCGMVM98Pv3T7qSlo,18445
 adcp/types/base.py,sha256=QoEuVfI4yzefup0dc2KN11AcJTbcGxRep7xOw5hXfs8,837
 adcp/types/core.py,sha256=RXkKCWCXS9BVJTNpe3Opm5O1I_LaQPMUuVwa-ipvS1Q,4839
-adcp/types/stable.py,sha256=AyTdam6W2AachsGi27GX_cAitw8TfogI0O62tuePKXk,4873
+adcp/types/stable.py,sha256=Q_rxnpLuUGfqGusiJcMuPADIGLQgs2uLp98S4YnAksw,4997
 adcp/types/generated_poc/__init__.py,sha256=bgFFvPK1-e04eOnyw0qmtVMzoA2V7GeAMPDVrx-VIwA,103
 adcp/types/generated_poc/activate_signal_request.py,sha256=mI1MskO30yEcbQQ7ueEExMF7FhfARQj0_kbz5CAdSzQ,1188
 adcp/types/generated_poc/activate_signal_response.py,sha256=ltt5yDsocK3VfELeRuMjUiNMmUZe__VP5az6fsMCOuc,2015
@@ -121,9 +121,9 @@ adcp/utils/__init__.py,sha256=uetvSJB19CjQbtwEYZiTnumJG11GsafQmXm5eR3hL7E,153
 adcp/utils/operation_id.py,sha256=wQX9Bb5epXzRq23xoeYPTqzu5yLuhshg7lKJZihcM2k,294
 adcp/utils/preview_cache.py,sha256=oc1AUkPrHHmUqfZa5920OCKY7qrDDR86XO6oi1PEHTA,18504
 adcp/utils/response_parser.py,sha256=uPk2vIH-RYZmq7y3i8lC4HTMQ3FfKdlgXKTjgJ1955M,6253
-adcp-2.4.1.dist-info/licenses/LICENSE,sha256=PF39NR3Ae8PLgBhg3Uxw6ju7iGVIf8hfv9LRWQdii_U,629
-adcp-2.4.1.dist-info/METADATA,sha256=UyKdK_BgJI9O3Cd3u1nPuCYTxk50-RlToMY0aZYlA_I,25057
-adcp-2.4.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-adcp-2.4.1.dist-info/entry_points.txt,sha256=DQKpcGsJX8DtVI_SGApQ7tNvqUB4zkTLaTAEpFgmi3U,44
-adcp-2.4.1.dist-info/top_level.txt,sha256=T1_NF0GefncFU9v_k56oDwKSJREyCqIM8lAwNZf0EOs,5
-adcp-2.4.1.dist-info/RECORD,,
+adcp-2.6.0.dist-info/licenses/LICENSE,sha256=PF39NR3Ae8PLgBhg3Uxw6ju7iGVIf8hfv9LRWQdii_U,629
+adcp-2.6.0.dist-info/METADATA,sha256=r91G1kiiN13GSt8F5PBOxJQiqHBayDibdtvAd8v-blI,25810
+adcp-2.6.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+adcp-2.6.0.dist-info/entry_points.txt,sha256=DQKpcGsJX8DtVI_SGApQ7tNvqUB4zkTLaTAEpFgmi3U,44
+adcp-2.6.0.dist-info/top_level.txt,sha256=T1_NF0GefncFU9v_k56oDwKSJREyCqIM8lAwNZf0EOs,5
+adcp-2.6.0.dist-info/RECORD,,