adcp 2.16.0__py3-none-any.whl → 2.18.0__py3-none-any.whl

adcp/ADCP_VERSION

@@ -1 +1 @@
-2.5.0
+2.6.0

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.16.0"
+__version__ = "2.18.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/__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/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-08 19:25:24 UTC
 """
 
 # ruff: noqa: E501, I001
@@ -75,6 +75,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,
@@ -399,9 +402,12 @@ __all__ = [
     "AdvertisingChannels",
     "AggregatedTotals",
     "Asset",
+    "Asset2",
     "AssetContentType",
     "AssetSelectors",
     "AssetType",
+    "Assets",
+    "Assets1",
     "AssetsRequired",
     "AssetsRequired1",
     "AssignedPackage",

adcp/types/generated_poc/adagents.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  adagents.json
-#   timestamp: 2025-12-18T20:00:24+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -14,7 +14,7 @@ from .core import property, property_id, property_tag, publisher_property_select
 
 class AuthorizedSalesAgents1(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     field_schema: Annotated[
         str | None,
@@ -34,7 +34,7 @@ class AuthorizedSalesAgents1(AdCPBaseModel):
 
 class Contact(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     domain: Annotated[
         str | None,
@@ -79,7 +79,7 @@ class Contact(AdCPBaseModel):
 
 class Tags(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     description: Annotated[str, Field(description='Description of what this tag represents')]
     name: Annotated[str, Field(description='Human-readable name for this tag')]
@@ -87,7 +87,7 @@ class Tags(AdCPBaseModel):
 
 class AuthorizedAgents(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     authorization_type: Annotated[
         Literal['property_ids'],
@@ -113,7 +113,7 @@ class AuthorizedAgents(AdCPBaseModel):
 
 class AuthorizedAgents1(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     authorization_type: Annotated[
         Literal['property_tags'],
@@ -139,7 +139,7 @@ class AuthorizedAgents1(AdCPBaseModel):
 
 class AuthorizedAgents3(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     authorization_type: Annotated[
         Literal['publisher_properties'],
@@ -167,7 +167,7 @@ class AuthorizedAgents3(AdCPBaseModel):
 
 class AuthorizedAgents2(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     authorization_type: Annotated[
         Literal['inline_properties'],
@@ -193,7 +193,7 @@ class AuthorizedAgents2(AdCPBaseModel):
 
 class AuthorizedSalesAgents2(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     field_schema: Annotated[
         str | None,
@@ -238,12 +238,12 @@ class AuthorizedSalesAgents(RootModel[AuthorizedSalesAgents1 | AuthorizedSalesAg
             description='Declaration of authorized sales agents for advertising inventory. Hosted at /.well-known/adagents.json on publisher domains. Can either contain the full structure inline or reference an authoritative URL.',
             examples=[
                 {
-                    '$schema': '/schemas/latest/adagents.json',
+                    '$schema': '/schemas/2.6.0/adagents.json',
                     'authoritative_location': 'https://cdn.example.com/adagents/v2/adagents.json',
                     'last_updated': '2025-01-15T10:00:00Z',
                 },
                 {
-                    '$schema': '/schemas/latest/adagents.json',
+                    '$schema': '/schemas/2.6.0/adagents.json',
                     'authorized_agents': [
                         {
                             'authorization_type': 'property_tags',
@@ -269,7 +269,7 @@ class AuthorizedSalesAgents(RootModel[AuthorizedSalesAgents1 | AuthorizedSalesAg
                     },
                 },
                 {
-                    '$schema': '/schemas/latest/adagents.json',
+                    '$schema': '/schemas/2.6.0/adagents.json',
                     'authorized_agents': [
                         {
                             'authorization_type': 'property_tags',
@@ -334,7 +334,7 @@ class AuthorizedSalesAgents(RootModel[AuthorizedSalesAgents1 | AuthorizedSalesAg
                     },
                 },
                 {
-                    '$schema': '/schemas/latest/adagents.json',
+                    '$schema': '/schemas/2.6.0/adagents.json',
                     'authorized_agents': [
                         {
                             'authorization_type': 'property_tags',
@@ -362,7 +362,7 @@ class AuthorizedSalesAgents(RootModel[AuthorizedSalesAgents1 | AuthorizedSalesAg
                     },
                 },
                 {
-                    '$schema': '/schemas/latest/adagents.json',
+                    '$schema': '/schemas/2.6.0/adagents.json',
                     'authorized_agents': [
                         {
                             'authorization_type': 'publisher_properties',

adcp/types/generated_poc/core/activation_key.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/activation_key.json
-#   timestamp: 2025-12-11T15:09:37+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -12,7 +12,7 @@ from pydantic import ConfigDict, Field, RootModel
 
 class ActivationKey1(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     segment_id: Annotated[
         str,
@@ -23,7 +23,7 @@ class ActivationKey1(AdCPBaseModel):
 
 class ActivationKey2(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     key: Annotated[str, Field(description='The targeting parameter key')]
     type: Annotated[Literal['key_value'], Field(description='Key-value pair based targeting')]

adcp/types/generated_poc/core/assets/audio_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/assets/audio_asset.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -12,7 +12,7 @@ from pydantic import AnyUrl, ConfigDict, Field
 
 class AudioAsset(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     bitrate_kbps: Annotated[
         int | None, Field(description='Audio bitrate in kilobits per second', ge=1)

adcp/types/generated_poc/core/assets/css_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/assets/css_asset.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -12,7 +12,7 @@ from pydantic import ConfigDict, Field
 
 class CssAsset(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     content: Annotated[str, Field(description='CSS content')]
     media: Annotated[

adcp/types/generated_poc/core/assets/daast_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/assets/daast_asset.json
-#   timestamp: 2025-12-11T15:09:37+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -15,7 +15,7 @@ from ...enums import daast_version as daast_version_1
 
 class DaastAsset1(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     companion_ads: Annotated[
         bool | None, Field(description='Whether companion display ads are included')
@@ -39,7 +39,7 @@ class DaastAsset1(AdCPBaseModel):
 
 class DaastAsset2(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     companion_ads: Annotated[
         bool | None, Field(description='Whether companion display ads are included')

adcp/types/generated_poc/core/assets/html_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/assets/html_asset.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -12,7 +12,7 @@ from pydantic import ConfigDict, Field
 
 class HtmlAsset(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     content: Annotated[str, Field(description='HTML content')]
     version: Annotated[str | None, Field(description="HTML version (e.g., 'HTML5')")] = None

adcp/types/generated_poc/core/assets/image_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/assets/image_asset.json
-#   timestamp: 2025-12-18T20:00:24+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -12,7 +12,7 @@ from pydantic import AnyUrl, ConfigDict, Field
 
 class ImageAsset(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     alt_text: Annotated[str | None, Field(description='Alternative text for accessibility')] = None
     format: Annotated[

adcp/types/generated_poc/core/assets/javascript_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/assets/javascript_asset.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -14,7 +14,7 @@ from ...enums import javascript_module_type
 
 class JavascriptAsset(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     content: Annotated[str, Field(description='JavaScript content')]
     module_type: Annotated[

adcp/types/generated_poc/core/assets/text_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/assets/text_asset.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -12,7 +12,7 @@ from pydantic import ConfigDict, Field
 
 class TextAsset(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     content: Annotated[str, Field(description='Text content')]
     language: Annotated[str | None, Field(description="Language code (e.g., 'en', 'es', 'fr')")] = (

adcp/types/generated_poc/core/assets/url_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/assets/url_asset.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -14,7 +14,7 @@ from ...enums import url_asset_type
 
 class UrlAsset(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     description: Annotated[
         str | None, Field(description='Description of what this URL points to')

adcp/types/generated_poc/core/assets/vast_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/assets/vast_asset.json
-#   timestamp: 2025-12-11T15:09:37+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -15,7 +15,7 @@ from ...enums import vast_version as vast_version_1
 
 class VastAsset1(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     delivery_type: Annotated[
         Literal['url'],
@@ -40,7 +40,7 @@ class VastAsset1(AdCPBaseModel):
 
 class VastAsset2(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     content: Annotated[str, Field(description='Inline VAST XML content')]
     delivery_type: Annotated[

adcp/types/generated_poc/core/assets/video_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/assets/video_asset.json
-#   timestamp: 2025-12-18T20:00:24+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -12,7 +12,7 @@ from pydantic import AnyUrl, ConfigDict, Field
 
 class VideoAsset(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     bitrate_kbps: Annotated[
         int | None, Field(description='Video bitrate in kilobits per second', ge=1)

adcp/types/generated_poc/core/assets/webhook_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/assets/webhook_asset.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -26,7 +26,7 @@ class Security(AdCPBaseModel):
 
 class WebhookAsset(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     method: Annotated[http_method.HttpMethod | None, Field(description='HTTP method')] = (
         http_method.HttpMethod.POST

adcp/types/generated_poc/core/brand_manifest.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/brand_manifest.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -15,7 +15,7 @@ from ..enums import asset_content_type
 
 class Asset(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     asset_id: Annotated[str, Field(description='Unique identifier for this asset')]
     asset_type: Annotated[
@@ -130,7 +130,7 @@ class UpdateFrequency(Enum):
 
 class ProductCatalog(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     categories: Annotated[
         list[str] | None,
@@ -150,7 +150,7 @@ class ProductCatalog(AdCPBaseModel):
 
 class BrandManifest(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     assets: Annotated[
         list[Asset] | None,

adcp/types/generated_poc/core/context.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/context.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -9,7 +9,6 @@ from pydantic import ConfigDict
 
 
 class ContextObject(AdCPBaseModel):
-    pass
     model_config = ConfigDict(
         extra='allow',
     )

adcp/types/generated_poc/core/creative_asset.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/creative_asset.json
-#   timestamp: 2025-12-11T15:09:37+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -27,7 +27,7 @@ from .assets import (
 
 class Input(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     context_description: Annotated[
         str | None,
@@ -41,7 +41,7 @@ class Input(AdCPBaseModel):
 
 class CreativeAsset(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     approved: Annotated[
         bool | None,

adcp/types/generated_poc/core/creative_assignment.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/creative_assignment.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -12,7 +12,7 @@ from pydantic import ConfigDict, Field
 
 class CreativeAssignment(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     creative_id: Annotated[str, Field(description='Unique identifier for the creative')]
     placement_ids: Annotated[

adcp/types/generated_poc/core/creative_filters.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/creative_filters.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -14,7 +14,7 @@ from ..enums import creative_status
 
 class CreativeFilters(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     assigned_to_package: Annotated[
         str | None, Field(description='Filter creatives assigned to this specific package')

adcp/types/generated_poc/core/creative_manifest.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/creative_manifest.json
-#   timestamp: 2025-12-11T15:09:37+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -29,7 +29,7 @@ from .assets import (
 
 class CreativeManifest(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     assets: Annotated[
         dict[

adcp/types/generated_poc/core/creative_policy.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  core/creative_policy.json
-#   timestamp: 2025-11-29T12:00:45+00:00
+#   timestamp: 2026-01-08T19:25:24+00:00
 
 from __future__ import annotations
 
@@ -14,7 +14,7 @@ from ..enums import co_branding_requirement, landing_page_requirement
 
 class CreativePolicy(AdCPBaseModel):
     model_config = ConfigDict(
-        extra='forbid',
+        extra='allow',
     )
     co_branding: Annotated[
         co_branding_requirement.CoBrandingRequirement, Field(description='Co-branding requirement')