adcp 1.1.0__tar.gz → 1.2.1__tar.gz

{adcp-1.1.0/src/adcp.egg-info → adcp-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: adcp
-Version: 1.1.0
+Version: 1.2.1
 Summary: Official Python client for the Ad Context Protocol (AdCP)
 Author-email: AdCP Community <maintainers@adcontextprotocol.org>
 License: Apache-2.0
@@ -59,6 +59,8 @@ AdCP operations are **distributed and asynchronous by default**. An agent might:
 pip install adcp
 ```
 
+> **Note**: This client requires Python 3.10 or later and supports both synchronous and asynchronous workflows.
+
 ## Quick Start: Distributed Operations
 
 ```python

{adcp-1.1.0 → adcp-1.2.1}/README.md

@@ -22,6 +22,8 @@ AdCP operations are **distributed and asynchronous by default**. An agent might:
 pip install adcp
 ```
 
+> **Note**: This client requires Python 3.10 or later and supports both synchronous and asynchronous workflows.
+
 ## Quick Start: Distributed Operations
 
 ```python

{adcp-1.1.0 → adcp-1.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "adcp"
-version = "1.1.0"
+version = "1.2.1"
 description = "Official Python client for the Ad Context Protocol (AdCP)"
 authors = [
     {name = "AdCP Community", email = "maintainers@adcontextprotocol.org"}

adcp-1.2.1/src/adcp/__init__.py

@@ -0,0 +1,266 @@
+from __future__ import annotations
+
+"""
+AdCP Python Client Library
+
+Official Python client for the Ad Context Protocol (AdCP).
+Supports both A2A and MCP protocols with full type safety.
+"""
+
+from adcp.client import ADCPClient, ADCPMultiAgentClient
+from adcp.exceptions import (
+    ADCPAuthenticationError,
+    ADCPConnectionError,
+    ADCPError,
+    ADCPProtocolError,
+    ADCPTimeoutError,
+    ADCPToolNotFoundError,
+    ADCPWebhookError,
+    ADCPWebhookSignatureError,
+)
+from adcp.types.core import AgentConfig, Protocol, TaskResult, TaskStatus, WebhookMetadata
+from adcp.types.generated import (
+    ActivateSignalError,
+    # Request/Response types
+    ActivateSignalRequest,
+    ActivateSignalResponse,
+    ActivateSignalSuccess,
+    ActivationKey,
+    AgentDeployment,
+    AgentDestination,
+    BothPreviewRender,
+    # Brand types
+    BrandManifest,
+    BrandManifestRef,
+    BuildCreativeRequest,
+    BuildCreativeResponse,
+    # Channel types
+    Channels,
+    CreateMediaBuyError,
+    CreateMediaBuyRequest,
+    CreateMediaBuyResponse,
+    CreateMediaBuySuccess,
+    # Creative types
+    CreativeAsset,
+    CreativeAssignment,
+    CreativeManifest,
+    CreativePolicy,
+    DaastAsset,
+    # Metrics types
+    DeliveryMetrics,
+    # Delivery types
+    DeliveryType,
+    Deployment,
+    # Deployment types
+    Destination,
+    Error,
+    Format,
+    FormatId,
+    FrequencyCap,
+    GetMediaBuyDeliveryRequest,
+    GetMediaBuyDeliveryResponse,
+    GetProductsRequest,
+    GetProductsResponse,
+    GetSignalsRequest,
+    GetSignalsResponse,
+    HtmlPreviewRender,
+    InlineDaastAsset,
+    InlineVastAsset,
+    Key_valueActivationKey,
+    ListAuthorizedPropertiesRequest,
+    ListAuthorizedPropertiesResponse,
+    ListCreativeFormatsRequest,
+    ListCreativeFormatsResponse,
+    ListCreativesRequest,
+    ListCreativesResponse,
+    Measurement,
+    # Core domain types
+    MediaBuy,
+    # Status enums
+    MediaBuyStatus,
+    # Sub-asset types
+    MediaSubAsset,
+    Pacing,
+    Package,
+    PackageStatus,
+    PerformanceFeedback,
+    Placement,
+    PlatformDeployment,
+    PlatformDestination,
+    PreviewCreativeRequest,
+    PreviewCreativeResponse,
+    # Preview render types
+    PreviewRender,
+    PricingModel,
+    # Pricing types
+    PricingOption,
+    Product,
+    PromotedProducts,
+    # Property and placement types
+    Property,
+    ProtocolEnvelope,
+    ProvidePerformanceFeedbackRequest,
+    ProvidePerformanceFeedbackResponse,
+    PushNotificationConfig,
+    ReportingCapabilities,
+    Response,
+    Segment_idActivationKey,
+    StandardFormatIds,
+    StartTiming,
+    SubAsset,
+    SyncCreativesError,
+    SyncCreativesRequest,
+    SyncCreativesResponse,
+    SyncCreativesSuccess,
+    # Targeting types
+    Targeting,
+    # Task types
+    TaskType,
+    TextSubAsset,
+    UpdateMediaBuyError,
+    UpdateMediaBuyRequest,
+    UpdateMediaBuyResponse,
+    UpdateMediaBuySuccess,
+    UrlDaastAsset,
+    UrlPreviewRender,
+    UrlVastAsset,
+    # Asset delivery types (VAST/DAAST)
+    VastAsset,
+    # Protocol types
+    WebhookPayload,
+)
+from adcp.types.generated import (
+    TaskStatus as GeneratedTaskStatus,
+)
+
+__version__ = "1.2.1"
+
+__all__ = [
+    # Client classes
+    "ADCPClient",
+    "ADCPMultiAgentClient",
+    # Core types
+    "AgentConfig",
+    "Protocol",
+    "TaskResult",
+    "TaskStatus",
+    "WebhookMetadata",
+    # Exceptions
+    "ADCPError",
+    "ADCPConnectionError",
+    "ADCPAuthenticationError",
+    "ADCPTimeoutError",
+    "ADCPProtocolError",
+    "ADCPToolNotFoundError",
+    "ADCPWebhookError",
+    "ADCPWebhookSignatureError",
+    # Request/Response types
+    "ActivateSignalRequest",
+    "ActivateSignalResponse",
+    "ActivateSignalSuccess",
+    "ActivateSignalError",
+    "ActivationKey",
+    "Segment_idActivationKey",
+    "Key_valueActivationKey",
+    "BuildCreativeRequest",
+    "BuildCreativeResponse",
+    "CreateMediaBuyRequest",
+    "CreateMediaBuyResponse",
+    "CreateMediaBuySuccess",
+    "CreateMediaBuyError",
+    "GetMediaBuyDeliveryRequest",
+    "GetMediaBuyDeliveryResponse",
+    "GetProductsRequest",
+    "GetProductsResponse",
+    "GetSignalsRequest",
+    "GetSignalsResponse",
+    "ListAuthorizedPropertiesRequest",
+    "ListAuthorizedPropertiesResponse",
+    "ListCreativeFormatsRequest",
+    "ListCreativeFormatsResponse",
+    "ListCreativesRequest",
+    "ListCreativesResponse",
+    "PreviewCreativeRequest",
+    "PreviewCreativeResponse",
+    "ProvidePerformanceFeedbackRequest",
+    "ProvidePerformanceFeedbackResponse",
+    "SyncCreativesRequest",
+    "SyncCreativesResponse",
+    "SyncCreativesSuccess",
+    "SyncCreativesError",
+    "UpdateMediaBuyRequest",
+    "UpdateMediaBuyResponse",
+    "UpdateMediaBuySuccess",
+    "UpdateMediaBuyError",
+    # Core domain types
+    "MediaBuy",
+    "Product",
+    "Package",
+    "Error",
+    # Creative types
+    "CreativeAsset",
+    "CreativeManifest",
+    "CreativeAssignment",
+    "CreativePolicy",
+    "Format",
+    "FormatId",
+    # Property and placement types
+    "Property",
+    "Placement",
+    # Targeting types
+    "Targeting",
+    "FrequencyCap",
+    "Pacing",
+    # Brand types
+    "BrandManifest",
+    "BrandManifestRef",
+    # Metrics types
+    "DeliveryMetrics",
+    "Measurement",
+    "PerformanceFeedback",
+    # Status enums
+    "MediaBuyStatus",
+    "PackageStatus",
+    # Pricing types
+    "PricingOption",
+    "PricingModel",
+    # Delivery types
+    "DeliveryType",
+    "StartTiming",
+    # Channel types
+    "Channels",
+    "StandardFormatIds",
+    # Protocol types
+    "WebhookPayload",
+    "ProtocolEnvelope",
+    "Response",
+    "PromotedProducts",
+    "PushNotificationConfig",
+    "ReportingCapabilities",
+    # Deployment types
+    "Destination",
+    "Deployment",
+    "PlatformDestination",
+    "AgentDestination",
+    "PlatformDeployment",
+    "AgentDeployment",
+    # Sub-asset types
+    "MediaSubAsset",
+    "SubAsset",
+    "TextSubAsset",
+    # Asset delivery types (VAST/DAAST)
+    "VastAsset",
+    "UrlVastAsset",
+    "InlineVastAsset",
+    "DaastAsset",
+    "UrlDaastAsset",
+    "InlineDaastAsset",
+    # Preview render types
+    "PreviewRender",
+    "UrlPreviewRender",
+    "HtmlPreviewRender",
+    "BothPreviewRender",
+    # Task types
+    "TaskType",
+    "GeneratedTaskStatus",
+]

{adcp-1.1.0 → adcp-1.2.1}/src/adcp/client.py

@@ -11,6 +11,8 @@ from collections.abc import Callable
 from datetime import datetime, timezone
 from typing import Any
 
+from pydantic import BaseModel
+
 from adcp.exceptions import ADCPWebhookSignatureError
 from adcp.protocols.a2a import A2AAdapter
 from adcp.protocols.base import ProtocolAdapter
@@ -154,7 +156,9 @@ class ADCPClient:
             )
         )
 
-        result = self.adapter._parse_response(raw_result, GetProductsResponse)
+        result: TaskResult[GetProductsResponse] = self.adapter._parse_response(
+            raw_result, GetProductsResponse
+        )
 
         if fetch_previews and result.success and result.data and creative_agent_client:
             from adcp.utils.preview_cache import add_preview_urls_to_products
@@ -215,7 +219,9 @@ class ADCPClient:
             )
         )
 
-        result = self.adapter._parse_response(raw_result, ListCreativeFormatsResponse)
+        result: TaskResult[ListCreativeFormatsResponse] = self.adapter._parse_response(
+            raw_result, ListCreativeFormatsResponse
+        )
 
         if fetch_previews and result.success and result.data:
             from adcp.utils.preview_cache import add_preview_urls_to_formats
@@ -617,15 +623,16 @@ class ADCPClient:
         from adcp.utils.response_parser import parse_json_or_text
 
         # Map task types to their response types (using string literals, not enum)
-        response_type_map: dict[str, type] = {
+        # Note: Some response types are Union types (e.g., ActivateSignalResponse = Success | Error)
+        response_type_map: dict[str, type[BaseModel] | Any] = {
             "get_products": GetProductsResponse,
             "list_creative_formats": ListCreativeFormatsResponse,
-            "sync_creatives": SyncCreativesResponse,
+            "sync_creatives": SyncCreativesResponse,  # Union type
             "list_creatives": ListCreativesResponse,
             "get_media_buy_delivery": GetMediaBuyDeliveryResponse,
             "list_authorized_properties": ListAuthorizedPropertiesResponse,
             "get_signals": GetSignalsResponse,
-            "activate_signal": ActivateSignalResponse,
+            "activate_signal": ActivateSignalResponse,  # Union type
             "provide_performance_feedback": ProvidePerformanceFeedbackResponse,
         }
 

{adcp-1.1.0 → adcp-1.2.1}/src/adcp/protocols/base.py

@@ -30,15 +30,18 @@ class ProtocolAdapter(ABC):
     # Helper methods for response parsing
     # ========================================================================
 
-    def _parse_response(self, raw_result: TaskResult[Any], response_type: type[T]) -> TaskResult[T]:
+    def _parse_response(
+        self, raw_result: TaskResult[Any], response_type: type[T] | Any
+    ) -> TaskResult[T]:
         """
         Parse raw TaskResult into typed TaskResult.
 
         Handles both MCP content arrays and A2A dict responses.
+        Supports both single types and Union types (for oneOf discriminated unions).
 
         Args:
             raw_result: Raw TaskResult from adapter
-            response_type: Expected Pydantic response type
+            response_type: Expected Pydantic response type (can be a Union type)
 
         Returns:
             Typed TaskResult