adcp 2.12.2__py3-none-any.whl → 2.13.0__py3-none-any.whl

adcp/__init__.py

@@ -179,7 +179,7 @@ from adcp.validation import (
     validate_publisher_properties_item,
 )
 
-__version__ = "2.12.2"
+__version__ = "2.13.0"
 
 
 def get_adcp_version() -> str:

adcp/types/base.py

@@ -2,10 +2,189 @@ from __future__ import annotations
 
 """Base model for AdCP types with spec-compliant serialization."""
 
+from collections.abc import Callable
 from typing import Any
 
 from pydantic import BaseModel
 
+# Type alias to shorten long type annotations
+MessageFormatter = Callable[[Any], str]
+
+
+def _pluralize(count: int, singular: str, plural: str | None = None) -> str:
+    """Return singular or plural form based on count."""
+    if count == 1:
+        return singular
+    return plural if plural else f"{singular}s"
+
+
+# Registry of human-readable message formatters for response types.
+# Key is the class name, value is a callable that takes the instance and returns a message.
+_RESPONSE_MESSAGE_REGISTRY: dict[str, MessageFormatter] = {}
+
+
+def _register_response_message(cls_name: str) -> Callable[[MessageFormatter], MessageFormatter]:
+    """Decorator to register a message formatter for a response type."""
+
+    def decorator(func: MessageFormatter) -> MessageFormatter:
+        _RESPONSE_MESSAGE_REGISTRY[cls_name] = func
+        return func
+
+    return decorator
+
+
+# Response message formatters
+@_register_response_message("GetProductsResponse")
+def _get_products_message(self: Any) -> str:
+    products = getattr(self, "products", None)
+    if products is None or len(products) == 0:
+        return "No products matched your requirements."
+    count = len(products)
+    return f"Found {count} {_pluralize(count, 'product')} matching your requirements."
+
+
+@_register_response_message("ListCreativeFormatsResponse")
+def _list_creative_formats_message(self: Any) -> str:
+    formats = getattr(self, "formats", None)
+    if formats is None:
+        return "No creative formats found."
+    count = len(formats)
+    return f"Found {count} supported creative {_pluralize(count, 'format')}."
+
+
+@_register_response_message("GetSignalsResponse")
+def _get_signals_message(self: Any) -> str:
+    signals = getattr(self, "signals", None)
+    if signals is None:
+        return "No signals found."
+    count = len(signals)
+    return f"Found {count} {_pluralize(count, 'signal')} available for targeting."
+
+
+@_register_response_message("ListAuthorizedPropertiesResponse")
+def _list_authorized_properties_message(self: Any) -> str:
+    domains = getattr(self, "publisher_domains", None)
+    if domains is None:
+        return "No authorized properties found."
+    count = len(domains)
+    return f"Authorized to represent {count} publisher {_pluralize(count, 'domain')}."
+
+
+@_register_response_message("ListCreativesResponse")
+def _list_creatives_message(self: Any) -> str:
+    creatives = getattr(self, "creatives", None)
+    if creatives is None:
+        return "No creatives found."
+    count = len(creatives)
+    return f"Found {count} {_pluralize(count, 'creative')} in the system."
+
+
+@_register_response_message("CreateMediaBuyResponse1")
+def _create_media_buy_success_message(self: Any) -> str:
+    media_buy_id = getattr(self, "media_buy_id", None)
+    packages = getattr(self, "packages", None)
+    package_count = len(packages) if packages else 0
+    return (
+        f"Media buy {media_buy_id} created with "
+        f"{package_count} {_pluralize(package_count, 'package')}."
+    )
+
+
+@_register_response_message("CreateMediaBuyResponse2")
+def _create_media_buy_error_message(self: Any) -> str:
+    errors = getattr(self, "errors", None)
+    error_count = len(errors) if errors else 0
+    return f"Media buy creation failed with {error_count} {_pluralize(error_count, 'error')}."
+
+
+@_register_response_message("UpdateMediaBuyResponse1")
+def _update_media_buy_success_message(self: Any) -> str:
+    media_buy_id = getattr(self, "media_buy_id", None)
+    return f"Media buy {media_buy_id} updated successfully."
+
+
+@_register_response_message("UpdateMediaBuyResponse2")
+def _update_media_buy_error_message(self: Any) -> str:
+    errors = getattr(self, "errors", None)
+    error_count = len(errors) if errors else 0
+    return f"Media buy update failed with {error_count} {_pluralize(error_count, 'error')}."
+
+
+@_register_response_message("SyncCreativesResponse1")
+def _sync_creatives_success_message(self: Any) -> str:
+    creatives = getattr(self, "creatives", None)
+    creative_count = len(creatives) if creatives else 0
+    return f"Synced {creative_count} {_pluralize(creative_count, 'creative')} successfully."
+
+
+@_register_response_message("SyncCreativesResponse2")
+def _sync_creatives_error_message(self: Any) -> str:
+    errors = getattr(self, "errors", None)
+    error_count = len(errors) if errors else 0
+    return f"Creative sync failed with {error_count} {_pluralize(error_count, 'error')}."
+
+
+@_register_response_message("ActivateSignalResponse1")
+def _activate_signal_success_message(self: Any) -> str:
+    return "Signal activated successfully."
+
+
+@_register_response_message("ActivateSignalResponse2")
+def _activate_signal_error_message(self: Any) -> str:
+    errors = getattr(self, "errors", None)
+    error_count = len(errors) if errors else 0
+    return f"Signal activation failed with {error_count} {_pluralize(error_count, 'error')}."
+
+
+@_register_response_message("PreviewCreativeResponse1")
+def _preview_creative_single_message(self: Any) -> str:
+    previews = getattr(self, "previews", None)
+    preview_count = len(previews) if previews else 0
+    return f"Generated {preview_count} {_pluralize(preview_count, 'preview')}."
+
+
+@_register_response_message("PreviewCreativeResponse2")
+def _preview_creative_batch_message(self: Any) -> str:
+    results = getattr(self, "results", None)
+    result_count = len(results) if results else 0
+    return f"Generated previews for {result_count} {_pluralize(result_count, 'manifest')}."
+
+
+@_register_response_message("BuildCreativeResponse1")
+def _build_creative_success_message(self: Any) -> str:
+    return "Creative built successfully."
+
+
+@_register_response_message("BuildCreativeResponse2")
+def _build_creative_error_message(self: Any) -> str:
+    errors = getattr(self, "errors", None)
+    error_count = len(errors) if errors else 0
+    return f"Creative build failed with {error_count} {_pluralize(error_count, 'error')}."
+
+
+@_register_response_message("GetMediaBuyDeliveryResponse")
+def _get_media_buy_delivery_message(self: Any) -> str:
+    deliveries = getattr(self, "media_buy_deliveries", None)
+    if deliveries is None:
+        return "No delivery data available."
+    count = len(deliveries)
+    return f"Retrieved delivery data for {count} media {_pluralize(count, 'buy', 'buys')}."
+
+
+@_register_response_message("ProvidePerformanceFeedbackResponse1")
+def _provide_performance_feedback_success_message(self: Any) -> str:
+    return "Performance feedback recorded successfully."
+
+
+@_register_response_message("ProvidePerformanceFeedbackResponse2")
+def _provide_performance_feedback_error_message(self: Any) -> str:
+    errors = getattr(self, "errors", None)
+    error_count = len(errors) if errors else 0
+    return (
+        f"Performance feedback recording failed with "
+        f"{error_count} {_pluralize(error_count, 'error')}."
+    )
+
 
 class AdCPBaseModel(BaseModel):
     """Base model for AdCP types with spec-compliant serialization.
@@ -24,3 +203,17 @@ class AdCPBaseModel(BaseModel):
         if "exclude_none" not in kwargs:
             kwargs["exclude_none"] = True
         return super().model_dump_json(**kwargs)
+
+    def summary(self) -> str:
+        """Human-readable summary for protocol responses.
+
+        Returns a standardized human-readable message suitable for MCP tool
+        results, A2A task communications, and REST API responses.
+
+        For types without a registered formatter, returns a generic message
+        with the class name.
+        """
+        formatter = _RESPONSE_MESSAGE_REGISTRY.get(self.__class__.__name__)
+        if formatter:
+            return formatter(self)
+        return f"{self.__class__.__name__} response"

{adcp-2.12.2.dist-info → adcp-2.13.0.dist-info}/METADATA

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

{adcp-2.12.2.dist-info → adcp-2.13.0.dist-info}/RECORD

@@ -1,5 +1,5 @@
 adcp/ADCP_VERSION,sha256=cy9k2HT5B4jAGZsMGb_Zs7ZDbhQBFOU-RigyUy10xhw,6
-adcp/__init__.py,sha256=tcd4sU6uHaJWAWmnfsNLhQEQF7FW7uNK1bdd-xKzaKQ,9933
+adcp/__init__.py,sha256=bc6VcbIXmZzfjXFmMV13x-5-5F9rFkir6B51hQsj34U,9933
 adcp/__main__.py,sha256=8v-j_W9IIWDIcvhaR1yuZAhBCDRfehUyN0tusstzyfQ,15139
 adcp/adagents.py,sha256=o-vTBmdZvu9aER-TAlLLL3s-WGYY8N67jnrAH24lST8,22333
 adcp/client.py,sha256=PQsmfpL-j2msTbWZkOcH0ZFGzPP9hh0QOPZ2fFrm8Q8,37149
@@ -17,7 +17,7 @@ adcp/testing/test_helpers.py,sha256=-UKuxxyKQald5EvXxguQH34b3J0JdsxKH_nRT6GTjkQ,
 adcp/types/__init__.py,sha256=bTEGjtbSbcCDYM2Y2f8bXdfJWS47FIw9UJJL5T7-wn4,13563
 adcp/types/_generated.py,sha256=eJg4J0TLOuFKrl32vI-fNFZ6vEhB2gBP6753VlA1PRE,20816
 adcp/types/aliases.py,sha256=PPBaWr-UMzfqVbg-592btdaqF1ATJWljtu8iiyV3RYQ,25142
-adcp/types/base.py,sha256=QoEuVfI4yzefup0dc2KN11AcJTbcGxRep7xOw5hXfs8,837
+adcp/types/base.py,sha256=Xr0cwbjG4tRPLbDTX9lucGty6_Y_S0a5C_ve0n7umc8,8227
 adcp/types/core.py,sha256=RXkKCWCXS9BVJTNpe3Opm5O1I_LaQPMUuVwa-ipvS1Q,4839
 adcp/types/generated_poc/__init__.py,sha256=bgFFvPK1-e04eOnyw0qmtVMzoA2V7GeAMPDVrx-VIwA,103
 adcp/types/generated_poc/adagents.py,sha256=lftHANcpBRj83vZn1wHUUO7zJjkXhWpWZ32CjlwbtnI,16438
@@ -168,9 +168,9 @@ adcp/utils/__init__.py,sha256=uetvSJB19CjQbtwEYZiTnumJG11GsafQmXm5eR3hL7E,153
 adcp/utils/operation_id.py,sha256=wQX9Bb5epXzRq23xoeYPTqzu5yLuhshg7lKJZihcM2k,294
 adcp/utils/preview_cache.py,sha256=rZTZfrN2MOvIWsvyyiNhrc2iVxoaFV_QaB1DlfsUH-Y,18668
 adcp/utils/response_parser.py,sha256=uPk2vIH-RYZmq7y3i8lC4HTMQ3FfKdlgXKTjgJ1955M,6253
-adcp-2.12.2.dist-info/licenses/LICENSE,sha256=PF39NR3Ae8PLgBhg3Uxw6ju7iGVIf8hfv9LRWQdii_U,629
-adcp-2.12.2.dist-info/METADATA,sha256=gzsbziBYljfvRI4Ol6fIvW8E8eKS7c7D_50oNkiFqWo,31358
-adcp-2.12.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-adcp-2.12.2.dist-info/entry_points.txt,sha256=DQKpcGsJX8DtVI_SGApQ7tNvqUB4zkTLaTAEpFgmi3U,44
-adcp-2.12.2.dist-info/top_level.txt,sha256=T1_NF0GefncFU9v_k56oDwKSJREyCqIM8lAwNZf0EOs,5
-adcp-2.12.2.dist-info/RECORD,,
+adcp-2.13.0.dist-info/licenses/LICENSE,sha256=PF39NR3Ae8PLgBhg3Uxw6ju7iGVIf8hfv9LRWQdii_U,629
+adcp-2.13.0.dist-info/METADATA,sha256=eiKsacoPkxO4J41f0-smMmz9CIkAXIRx7oYwzcjbxvg,31358
+adcp-2.13.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+adcp-2.13.0.dist-info/entry_points.txt,sha256=DQKpcGsJX8DtVI_SGApQ7tNvqUB4zkTLaTAEpFgmi3U,44
+adcp-2.13.0.dist-info/top_level.txt,sha256=T1_NF0GefncFU9v_k56oDwKSJREyCqIM8lAwNZf0EOs,5
+adcp-2.13.0.dist-info/RECORD,,