adcp 2.17.0__tar.gz → 2.19.0__tar.gz

{adcp-2.17.0/src/adcp.egg-info → adcp-2.19.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: adcp
-Version: 2.17.0
+Version: 2.19.0
 Summary: Official Python client for the Ad Context Protocol (AdCP)
 Author-email: AdCP Community <maintainers@adcontextprotocol.org>
 License: Apache-2.0

{adcp-2.17.0 → adcp-2.19.0}/pyproject.toml

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

adcp-2.19.0/src/adcp/ADCP_VERSION

@@ -0,0 +1 @@
+2.6.0

{adcp-2.17.0 → adcp-2.19.0}/src/adcp/__init__.py

@@ -172,6 +172,17 @@ from adcp.types.aliases import (
     UrlVastAsset,
 )
 from adcp.types.core import AgentConfig, Protocol, TaskResult, TaskStatus, WebhookMetadata
+from adcp.utils import (
+    get_asset_count,
+    get_format_assets,
+    get_individual_assets,
+    get_optional_assets,
+    get_repeatable_groups,
+    get_required_assets,
+    has_assets,
+    normalize_assets_required,
+    uses_deprecated_assets_field,
+)
 from adcp.validation import (
     ValidationError,
     validate_adagents,
@@ -186,7 +197,7 @@ from adcp.webhooks import (
     get_adcp_signed_headers_for_webhook,
 )
 
-__version__ = "2.17.0"
+__version__ = "2.19.0"
 
 
 def get_adcp_version() -> str:
@@ -333,6 +344,16 @@ __all__ = [
     "validate_agent_authorization",
     "validate_product",
     "validate_publisher_properties_item",
+    # Format asset utilities
+    "get_format_assets",
+    "normalize_assets_required",
+    "get_required_assets",
+    "get_optional_assets",
+    "get_individual_assets",
+    "get_repeatable_groups",
+    "uses_deprecated_assets_field",
+    "get_asset_count",
+    "has_assets",
     # Generated types modules
     "generated",
     "aliases",

{adcp-2.17.0 → adcp-2.19.0}/src/adcp/__main__.py

@@ -32,8 +32,80 @@ def print_json(data: Any) -> None:
         print(json.dumps(data, indent=2, default=str))
 
 
+def _check_deprecated_fields(data: Any) -> None:
+    """Check response data for deprecated fields and emit warnings to stderr.
+
+    Uses Pydantic's Field(deprecated=True) metadata to generically detect
+    any deprecated fields that are populated in the response.
+    """
+    from pydantic import BaseModel
+
+    deprecated_found: set[str] = set()
+
+    def _find_deprecated_fields(obj: Any, visited: set[int] | None = None) -> None:
+        """Recursively find deprecated fields that are populated."""
+        if obj is None:
+            return
+
+        # Prevent infinite recursion on circular references
+        if visited is None:
+            visited = set()
+        obj_id = id(obj)
+        if obj_id in visited:
+            return
+        visited.add(obj_id)
+
+        # Check Pydantic models for deprecated fields
+        if isinstance(obj, BaseModel):
+            import warnings
+
+            # Access model_fields from the class, not the instance (Pydantic v2.11+)
+            model_fields = type(obj).model_fields
+
+            for field_name, field_info in model_fields.items():
+                if field_info.deprecated:
+                    # Suppress Pydantic's DeprecationWarning when accessing deprecated fields
+                    with warnings.catch_warnings():
+                        warnings.simplefilter("ignore", DeprecationWarning)
+                        value = getattr(obj, field_name, None)
+                    if value is not None:
+                        deprecated_found.add(field_name)
+
+            # Recursively check field values
+            for field_name in model_fields:
+                with warnings.catch_warnings():
+                    warnings.simplefilter("ignore", DeprecationWarning)
+                    value = getattr(obj, field_name, None)
+                if value is not None:
+                    _find_deprecated_fields(value, visited)
+
+        # Check lists
+        elif isinstance(obj, list):
+            for item in obj:
+                _find_deprecated_fields(item, visited)
+
+        # Check dicts
+        elif isinstance(obj, dict):
+            for value in obj.values():
+                _find_deprecated_fields(value, visited)
+
+    _find_deprecated_fields(data)
+
+    if deprecated_found:
+        fields_list = ", ".join(f"'{f}'" for f in sorted(deprecated_found))
+        print(
+            f"\n⚠️  Warning: Response contains deprecated field(s): {fields_list}\n"
+            "   See field descriptions or AdCP spec for migration details.\n",
+            file=sys.stderr,
+        )
+
+
 def print_result(result: Any, json_output: bool = False) -> None:
     """Print result in formatted or JSON mode."""
+    # Check for deprecated fields and warn (to stderr, so JSON output isn't affected)
+    if result.success and result.data:
+        _check_deprecated_fields(result.data)
+
     if json_output:
         # Match JavaScript client: output just the data for scripting
         if result.success and result.data:

{adcp-2.17.0 → adcp-2.19.0}/src/adcp/protocols/mcp.py

@@ -136,7 +136,9 @@ class MCPAdapter(ProtocolAdapter):
             and ("cancel scope" in exc_str or "async context" in exc_str)
         ) or (
             # HTTP errors during cleanup (if httpx is available)
-            HTTPX_AVAILABLE and HTTPStatusError is not None and isinstance(exc, HTTPStatusError)
+            HTTPX_AVAILABLE
+            and HTTPStatusError is not None
+            and isinstance(exc, HTTPStatusError)
         )
 
         if is_known_cleanup_error:

{adcp-2.17.0 → adcp-2.19.0}/src/adcp/types/_ergonomic.py

@@ -39,8 +39,6 @@ from adcp.types.coercion import (
     coerce_to_enum_list,
     coerce_to_model,
 )
-
-# Import types that need coercion
 from adcp.types.generated_poc.core.context import ContextObject
 from adcp.types.generated_poc.core.creative_asset import CreativeAsset
 from adcp.types.generated_poc.core.creative_assignment import CreativeAssignment
@@ -57,8 +55,6 @@ from adcp.types.generated_poc.enums.sort_direction import SortDirection
 from adcp.types.generated_poc.media_buy.create_media_buy_request import (
     CreateMediaBuyRequest,
 )
-
-# Response types
 from adcp.types.generated_poc.media_buy.create_media_buy_response import (
     CreateMediaBuyResponse1,
 )

{adcp-2.17.0 → adcp-2.19.0}/src/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-12-18 20:00:25 UTC
+Generation date: 2026-01-14 17:08:13 UTC
 """
 
 # ruff: noqa: E501, I001
@@ -26,6 +26,7 @@ from adcp.types.generated_poc.adagents import (
     AuthorizedSalesAgents1,
     AuthorizedSalesAgents2,
     Contact,
+    PropertyFeature,
     Tags,
 )
 from adcp.types.generated_poc.core.activation_key import (
@@ -75,6 +76,9 @@ from adcp.types.generated_poc.core.destination import Destination, Destination1,
 from adcp.types.generated_poc.core.error import Error
 from adcp.types.generated_poc.core.ext import ExtensionObject
 from adcp.types.generated_poc.core.format import (
+    Asset2,
+    Assets,
+    Assets1,
     AssetsRequired,
     AssetsRequired1,
     Dimensions,
@@ -88,6 +92,7 @@ from adcp.types.generated_poc.core.format import (
 )
 from adcp.types.generated_poc.core.format_id import FormatId
 from adcp.types.generated_poc.core.frequency_cap import FrequencyCap
+from adcp.types.generated_poc.core.identifier import Identifier
 from adcp.types.generated_poc.core.mcp_webhook_payload import McpWebhookPayload
 from adcp.types.generated_poc.core.measurement import Measurement
 from adcp.types.generated_poc.core.media_buy import MediaBuy
@@ -117,8 +122,9 @@ from adcp.types.generated_poc.core.promoted_offerings import (
     PromotedOfferings,
 )
 from adcp.types.generated_poc.core.promoted_products import PromotedProducts
-from adcp.types.generated_poc.core.property import Identifier, Property
+from adcp.types.generated_poc.core.property import Property
 from adcp.types.generated_poc.core.property_id import PropertyId
+from adcp.types.generated_poc.core.property_list_ref import PropertyListReference
 from adcp.types.generated_poc.core.property_tag import PropertyTag
 from adcp.types.generated_poc.core.protocol_envelope import ProtocolEnvelope
 from adcp.types.generated_poc.core.publisher_property_selector import (
@@ -216,6 +222,7 @@ from adcp.types.generated_poc.enums.vast_tracking_event import VastTrackingEvent
 from adcp.types.generated_poc.enums.vast_version import VastVersion
 from adcp.types.generated_poc.enums.webhook_response_type import WebhookResponseType
 from adcp.types.generated_poc.enums.webhook_security_method import WebhookSecurityMethod
+from adcp.types.generated_poc.extensions.extension_meta import AdcpExtensionFileSchema
 from adcp.types.generated_poc.media_buy.build_creative_request import BuildCreativeRequest
 from adcp.types.generated_poc.media_buy.build_creative_response import (
     BuildCreativeResponse,
@@ -361,8 +368,53 @@ from adcp.types.generated_poc.pricing_options.cpv_option import (
 from adcp.types.generated_poc.pricing_options.flat_rate_option import FlatRatePricingOption
 from adcp.types.generated_poc.pricing_options.vcpm_auction_option import VcpmAuctionPricingOption
 from adcp.types.generated_poc.pricing_options.vcpm_fixed_option import VcpmFixedRatePricingOption
+from adcp.types.generated_poc.property.base_property_source import (
+    BasePropertySource,
+    BasePropertySource1,
+    BasePropertySource2,
+    BasePropertySource3,
+)
+from adcp.types.generated_poc.property.create_property_list_request import CreatePropertyListRequest
+from adcp.types.generated_poc.property.create_property_list_response import (
+    CreatePropertyListResponse,
+)
+from adcp.types.generated_poc.property.delete_property_list_request import DeletePropertyListRequest
+from adcp.types.generated_poc.property.delete_property_list_response import (
+    DeletePropertyListResponse,
+)
+from adcp.types.generated_poc.property.feature_requirement import FeatureRequirement, IfNotCovered
+from adcp.types.generated_poc.property.get_property_list_request import GetPropertyListRequest
+from adcp.types.generated_poc.property.get_property_list_response import GetPropertyListResponse
+from adcp.types.generated_poc.property.list_property_features_request import (
+    ListPropertyFeaturesRequest,
+)
+from adcp.types.generated_poc.property.list_property_features_response import (
+    ListPropertyFeaturesResponse,
+)
+from adcp.types.generated_poc.property.list_property_lists_request import ListPropertyListsRequest
+from adcp.types.generated_poc.property.list_property_lists_response import ListPropertyListsResponse
+from adcp.types.generated_poc.property.property_error import Code, PropertyError
+from adcp.types.generated_poc.property.property_feature_definition import (
+    Coverage,
+    PropertyFeatureDefinition,
+    Range,
+)
+from adcp.types.generated_poc.property.property_list import PropertyList
+from adcp.types.generated_poc.property.property_list_changed_webhook import (
+    ChangeSummary,
+    PropertyListChangedWebhook,
+)
+from adcp.types.generated_poc.property.property_list_filters import (
+    CountriesAllItem,
+    PropertyListFilters,
+)
+from adcp.types.generated_poc.property.update_property_list_request import UpdatePropertyListRequest
+from adcp.types.generated_poc.property.update_property_list_response import (
+    UpdatePropertyListResponse,
+)
 from adcp.types.generated_poc.protocols.adcp_extension import (
-    AdcpAgentCardExtension,
+    AdcpAgentCardExtensionParams,
+    ExtensionsSupportedItem,
     ProtocolsSupportedEnum,
 )
 from adcp.types.generated_poc.signals.activate_signal_request import ActivateSignalRequest
@@ -393,15 +445,19 @@ __all__ = [
     "ActivationKey",
     "ActivationKey1",
     "ActivationKey2",
-    "AdcpAgentCardExtension",
+    "AdcpAgentCardExtensionParams",
     "AdcpAsyncResponseData",
     "AdcpDomain",
+    "AdcpExtensionFileSchema",
     "AdvertisingChannels",
     "AggregatedTotals",
     "Asset",
+    "Asset2",
     "AssetContentType",
     "AssetSelectors",
     "AssetType",
+    "Assets",
+    "Assets1",
     "AssetsRequired",
     "AssetsRequired1",
     "AssignedPackage",
@@ -417,6 +473,10 @@ __all__ = [
     "AuthorizedSalesAgents1",
     "AuthorizedSalesAgents2",
     "AvailableMetric",
+    "BasePropertySource",
+    "BasePropertySource1",
+    "BasePropertySource2",
+    "BasePropertySource3",
     "BrandManifest",
     "BrandManifestReference",
     "BudgetRange",
@@ -426,12 +486,16 @@ __all__ = [
     "BuildCreativeResponse1",
     "BuildCreativeResponse2",
     "ByPackageItem",
+    "ChangeSummary",
     "Channels",
     "CoBrandingRequirement",
+    "Code",
     "Colors",
     "Contact",
     "ContextObject",
+    "CountriesAllItem",
     "Country",
+    "Coverage",
     "CpcPricingOption",
     "CpcvPricingOption",
     "CpmAuctionPricingOption",
@@ -445,6 +509,8 @@ __all__ = [
     "CreateMediaBuyResponse2",
     "CreateMediaBuySubmitted",
     "CreateMediaBuyWorking",
+    "CreatePropertyListRequest",
+    "CreatePropertyListResponse",
     "Creative",
     "CreativeAction",
     "CreativeAgent",
@@ -463,6 +529,8 @@ __all__ = [
     "DaastTrackingEvent",
     "DaastVersion",
     "DailyBreakdownItem",
+    "DeletePropertyListRequest",
+    "DeletePropertyListResponse",
     "DeliverTo",
     "DeliveryMeasurement",
     "DeliveryMetrics",
@@ -482,6 +550,8 @@ __all__ = [
     "Embedding",
     "Error",
     "ExtensionObject",
+    "ExtensionsSupportedItem",
+    "FeatureRequirement",
     "FeedFormat",
     "FeedbackSource",
     "FieldModel",
@@ -503,12 +573,15 @@ __all__ = [
     "GetProductsResponse",
     "GetProductsSubmitted",
     "GetProductsWorking",
+    "GetPropertyListRequest",
+    "GetPropertyListResponse",
     "GetSignalsRequest",
     "GetSignalsResponse",
     "HistoryEntryType",
     "HtmlAsset",
     "HttpMethod",
     "Identifier",
+    "IfNotCovered",
     "ImageAsset",
     "Input",
     "Input2",
@@ -524,6 +597,10 @@ __all__ = [
     "ListCreativeFormatsResponseCreativeAgent",
     "ListCreativesRequest",
     "ListCreativesResponse",
+    "ListPropertyFeaturesRequest",
+    "ListPropertyFeaturesResponse",
+    "ListPropertyListsRequest",
+    "ListPropertyListsResponse",
     "Logo",
     "MarkdownFlavor",
     "McpWebhookPayload",
@@ -574,8 +651,15 @@ __all__ = [
     "PromotedOfferings",
     "PromotedProducts",
     "Property",
+    "PropertyError",
+    "PropertyFeature",
+    "PropertyFeatureDefinition",
     "PropertyId",
     "PropertyIdentifierTypes",
+    "PropertyList",
+    "PropertyListChangedWebhook",
+    "PropertyListFilters",
+    "PropertyListReference",
     "PropertyTag",
     "PropertyType",
     "ProtocolEnvelope",
@@ -596,6 +680,7 @@ __all__ = [
     "PushNotificationConfig",
     "QuartileData",
     "QuerySummary",
+    "Range",
     "Reason",
     "Renders",
     "Renders1",
@@ -648,6 +733,8 @@ __all__ = [
     "UpdateMediaBuyResponse2",
     "UpdateMediaBuySubmitted",
     "UpdateMediaBuyWorking",
+    "UpdatePropertyListRequest",
+    "UpdatePropertyListResponse",
     "UrlAsset",
     "UrlAssetType",
     "ValidationMode",